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Avant-propos 


L es téléphones mobiles sont sans conteste la plus grande révolution technologique 
que l’on ait connue ces dernières années. Très vite, ils ont modifié nos habitudes 
et sont devenus indispensables pour beaucoup d’entre nous. 

Tout a commencé en janvier 2007, à San Francisco. Notre regretté Steve Jobs présentait 
alors le premier iPhone pendant le salon professionnel Macworld. Cet appareil extra- 
ordinaire regroupait un combiné GSM, un assistant personnel, un baladeur compatible 
MP3 et une visionneuse multimédia ! Le design très soigné de l’iPhone et sa prise en 
main immédiate ont immédiatement séduit le public. Et depuis, cet engouement n’a 
cessé de progresser. Il faut bien dire qu’aujourd’hui, avec plus de 500 000 applications 
disponibles sur l’App Store, les possibilités de l’iPhone ont de quoi donner le vertige. 

Trois ans plus tard, en janvier 2010, toujours à San Francisco, Steve Jobs présentait 
la tablette iPad 1. Là encore, le public a été très vite séduit par ce « gros iPhone sans 
téléphone » ! Aujourd’hui, c’est-à-dire deux ans plus tard, l’App Store propose plus de 
140 000 applications pour iPad. 

Si vous aussi, vous voulez faire partie de cette grande famille de développeurs pour 
iPhone, iPad et iPod Touch, vous avez le bon ouvrage entre les mains ! Que vous soyez 
un programmeur débutant ou confirmé, je vous montrerai au fil des pages comment 
tirer parti des immenses possibilités de ces appareils. Rapidement, vous serez capables 
de créer vos propres applications. . . avec une facilité déconcertante ! Lors de vos pre- 
miers pas, vous devrez faire preuve de patience pour bien intégrer les techniques de 
programmation si spécifiques au monde Apple. Mais bien vite, vous verrez que ce code 
qui pourrait passer pour barbare aux yeux d’un profane, n’a rien de bien compliqué et 
revêt même une certaine « élégance »... 

Bienvenue dans le monde magique de la programmation iOS ! 

Qu’allez- vous apprendre en lisant ce livre ? 

Le plan de ce livre a été conçu pour faciliter votre découverte et votre apprentissage 
de la programmation iOS. Voici le chemin que nous allons parcourir : 

1. Tout ce qu’il faut savoir avant de commencer : cette partie introductive va 
passer en revue tout ce dont vous aurez besoin pour pouvoir programmer, tant 


î 
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au niveau matériel que logiciel. Vous y trouverez toutes sortes d’informations 
pratiques qui vous permettront de démarrer sereinement. Ensuite, vous ferez 
vos débuts en programmation Objective-C, avant de tester votre toute première 
application. Peu importe que vous ayez ou non un iPhone/iPad/iPod Touch pour 
tester cette application : nous utiliserons le simulateur iOS. 

2. Le langage Objective-C : cette partie est essentielle si vous débutez en pro- 
grammation Objective-C, et encore plus si vous débutez en programmation tout 
court. Elle va vous dévoiler les principaux mécanismes qu’il est bon d’avoir à 
l’esprit avant de commencer à plonger dans le code. Après avoir découvert les 
bases de l’Objec.tive-C (instructions, variables, opérateurs, types, tests, boucles, 
fonctions), vous en apprendrez un peu plus sur le côté objet du langage, et en 
particulier sur les classes et les méthodes. Cette étape franchie, vous verrez com- 
ment dialoguer avec les méthodes des classes les plus courantes. Et pour terminer 
en beauté, vous mettrez en pratique tout ce que vous avez appris pour développer 
un jeu de Mastermind. 

3. Création d’interfaces graphiques : dans cette partie, vous allez faire plus 
ample connaissance avec Interface Builder et découvrir ses immenses possibilités 
pour créer des interfaces graphiques évoluées. Au fil des pages, vous apprendrez à 
mettre en place des fenêtres, des vues et des contrôles et à les relier au code pour 
pouvoir dialoguer avec eux. Vous verrez également comment insérer des contrôles 
dans une vue en faisant abstraction d’interface Builder, c’est-à-dire en utilisant 
uniquement des instructions Objective-C. Tout ce que vous avez appris dans cette 
partie sera mis en pratique en développant une application qui facilite l’affichage 
de vos pages Web préférées. 

4. Plus loin avec iOS 5 : Arrivés à ce point dans la lecture du livre, vous savez 
créer de petites applications iOS 5. Il est temps de passer à la vitesse supérieure 
en abordant des sujets qui sont chers à tous les utilisateurs d’iPhone, iPod Touch 
et iPad : la géolocalisation, la lecture et l’enregistrement audio, la lecture vidéo, 
la prise de photos, l’utilisation de l’accéléromètre et le jeu. Bien entendu, vous 
expérimenterez tout ce que vous avez appris en développant une application en 
solo. Ici, vous développerez un jeu qui met en pratique l’utilisation d’un timer, le 
déplacement de sprites, le test de collisions, le toucher de l’écran, l’utilisation de 
bruitages et d’une musique de fond. 

5. Tester et publier ses applications : ça y est, vous avez créé une application 
qui a toutes les chances de devenir un best-seller et vous mourez d’envie de la 
rendre disponible aux possesseurs d’iPhone, d’iPod Touch et d’iPad du monde 
entier ? Cette partie va vous montrer comment procéder ! Après avoir souscrit au 
programme de développement iOS, vous verrez comment tester vos applications 
sur un ou plusieurs devices. Cette étape passée avec succès, je vous conseille de 
tester votre application « en long et en large » pour vous assurer qu’elle fonctionne 
parfaitement. Je vous montrerai alors comment la soumettre à Apple, puis, après 
acceptation, la rendre accessible à travers l’App Store. 
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COMMENT LIRE CE LIVRE ? 


Comment lire ce livre ? 

Suivez l’ordre des chapitres 

Lisez ce livre comme on lit un roman. Il a été conçu pour cela. 

Contrairement à beaucoup de livres techniques où il est courant de lire en diagonale et 
de sauter certains chapitres, il est ici très fortement recommandé de suivre l’ordre du 
cours, à moins que vous ne soyez déjà un peu expérimentés. 


Pratiquez en même temps 

Pratiquez régulièrement. N’attendez pas d’avoir fini de lire ce livre pour allumer votre 
ordinateur et faire vos propres essais. 


Utilisez les codes web ! 


Afin de tirer parti du Site du Zéro dont ce livre est issu, celui-ci vous propose ce qu’on 
appelle des « codes web » . Ce sont des codes à six chiffres à saisir sur une page du Site 
du Zéro pour être automatiquement redirigé vers un site web sans avoir à en recopier 
l’adresse. 


Pour utiliser les codes web, rendez-vous sur la page suivante 1 : 


http : //www. siteduzero . com/ codeweb.html 


Un formulaire vous invite à rentrer votre code web. Faites un premier essai avec le code 
ci-dessous : 


> 


Tester le code web 
Uode web : 123456 


Ces codes web ont deux intérêts : 


- ils vous redirigent vers les sites web présentés tout au long du cours, vous permettant 
ainsi d’obtenir les logiciels dans leur toute dernière version ; 

- ils vous permettent de télécharger les codes sources inclus dans ce livre, ce qui vous 
évitera d’avoir à recopier certains programmes un peu longs. 

Ce système de redirection nous permet de tenir à jour le livre que vous avez entre les 
mains sans que vous ayez besoin d’acheter systématiquement chaque nouvelle édition. 
Si un site web change d’adresse, nous modifierons la redirection mais le code web à 
utiliser restera le même. Si un site web disparaît, nous vous redirigerons vers une page 
du Site du Zéro expliquant ce qui s’est passé et vous proposant une alternative. 

En clair, c’est un moyen de nous assurer de la pérennité de cet ouvrage sans que vous 
ayez à faire quoi que ce soit ! 


1. Vous pouvez aussi utiliser le formulaire de recherche du Site du Zéro, section « Code web ». 
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L’équipement du codeur 


Difficulté : — 

C a y est, vous êtes prêts à franchir le pas et à développer des applications pour les 
périphériques mobiles Apple? Vous devez certainement vous demander si cela est 
/ possible et si vous y arriverez. 

Rien n'est impossible! Surtout que je vais vous accompagner tout au long de votre ap- 
prentissage. Peu importe si vous n'avez jamais utilisé de Mac ou si vous n'avez aucune 
expérience en programmation. Avec de la volonté et armés de ce livre, vous vous en sortirez 
haut la main. 

Si vous êtes prêts à tenter l'aventure, voyons de quel matériel vous aurez besoin. 
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De quel ordinateur s’équiper ? 


Comment ça, de quel ordinateur s'équiper? J'ai déjà un PC et j'en suis sa- 
tisfait ! Pourquoi est-ce que je devrais investir dans un nouveau matériel ? 

Eh bien, je suis désolé de vous l’apprendre, mais les développements pour iPhone, iPad 
et iPod Touch se font presque exclusivement sur Mac. Et ce n’est pas tout ! Le Mac 
doit : 

1. être équipé d’un processeur Intel; 

2. posséder au moins 1 gigaoctet (1 Go) de mémoire vive; 

3. utiliser le système d’exploitation Mac OS X Lion, Snow Léopard ou Léopard ; 

4. disposer d’un port USB libre et/ou d’une connexion wifi afin de connecter votre 
iPhone/iPod Touch/iPad à l’ordinateur et de tester vos applications. 


Presque exclusivement sur un Mac? Des précisions s'il vous plaît? 


Il est également possible de développer des applications pour les produits Apple en 
utilisant un ordinateur fonctionnant sous Windows ou Linux, mais ce n’est (vraiment) 
pas la voie la plus simple, ni bien évidemment celle recommandée par Apple. Ce livre 
s’intéressera uniquement à la méthode de développement traditionnelle : sur un Mac, 
via l’application Xcode. 

Si vous possédez déjà un Mac, je vais vous montrer comment savoir s’il est équipé en 
conséquence : cliquez sur la pomme dans le Finder et sélectionnez À propos de ce 
Mac dans le menu. À la figure 1.1 par exemple, le Mac est équipé d’un processeur Intel 
Core 2 Duo et utilise le système OS X 10.6.7, donc Snow Léopard. 

Les trois dernières versions du système d’exploitation Mac OS X sont les suivantes : 

- 10.7.x : Lion ; 

- 10.6.x : Snow Léopard ; 

- 10.5.x : Léopard. 

Si vous devez vous équiper, allez faire un tour sur l’Apple Store. Tous les Mac vendus 
dans le Store peuvent être utilisés. Selon votre budget, vous choisirez un Mac Mini, un 
MacBook, un MacBook Air, un MacBook Pro ou un iMac. 

Si votre budget est limité, rabattez-vous sur une machine reconditionnée. Vous y trou- 
verez des Mac testés et agréés par Apple. Sous garantie pendant un an, les machines 
proposées sont à un prix sensiblement inférieur à celui du neuf et (sauf exception) dans 
un excellent état ! 

Dans la mesure du possible, investissez dans un écran large de 22 ou 24 pouces. Comme 
vous le verrez dans ce livre, l’environnement de développement est à l’aise sur un grand 
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À propos de ce Mac 



Mac OS X 

Version 10.6.7 

r Mise à jour de logiciels... ) 

Processeur 2.4 CHz Intel Core 2 Duo 

Mémoire 2 Go 1067 MHz DDR3 

Disque de démarrage Macintosh HD 

( Plus d'infos... ") 

TM et© 1983-2011 Apple Inc. 

Tous droits réservés. 


Figure 1.1 - Quelques informations à propos du Mac 

écran, et un 22 pouces n’est vraiment pas un luxe ! Si vous êtes déjà équipés d’un écran 
pour PC, vous pourrez le connecter sur votre Mac, à condition que sa connexion soit 
de type DVI (figure 1.2). 



Figure 1.2 - Une prise DVI 

J’entends déjà bon nombre d’entre vous se plaindre : « mon écran n’a qu’un connecteur 
VGA! Est-ce que je dois acheter un nouvel écran? » Non, rassurez- vous, il vous suffit 
d’acheter un adaptateur VGA/DVI (figure 1.3). Pour quelques euros, vous pourrez 
connecter votre Mac sur votre écran VGA. 



Figure 1.3 - Un adaptateur VGA/DVI 

Pour les plus ambitieux d’entre vous, sachez qu’il est possible de connecter deux écrans 
sur tous les Mac récents. À vous de trouver les adaptateurs qui conviennent, comme 
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par exemple un Mini DisplayPort/VGA (figure 1.4). 



Figure 1.4 - À gauche un Mini DisplayPort /VGA et à droite un Mini DisplayPort /DVI 


Un autre matériel est-il nécessaire ? 

Je vais encore jouer les rabat-joie : il ne suffit pas d’être équipé d’un Mac pour écrire 
des applications destinées aux appareils mobiles Apple. Vous devez également posséder 
un iPhone, un iPod Touch et/ou un iPad. Ou encore mieux, les trois! 

En effet, si l’environnement de développement est en mesure de simuler le fonction- 
nement de ces trois appareils, le comportement des applications est cependant biaisé 
car elles ne disposent pas des mêmes ressources (mémoire et processeur) si elles sont 
exécutées sur un Mac ou sur un device (entendez par là un iPhone, un iPad ou un 
iPod Touch). 

Retenez bien ce terme de device, je l'utiliserai par la suite pour désigner un 
iPhone, un iPad, un iPod Touch, ou même les trois en même temps. 

Une bonne nouvelle : les iPod Touch et les iPad sont également disponibles en version 
reconditionnée ! Vous pourrez faire de substantielles économies en vous rendant sur 
ces pages. Par cet intermédiaire, je me suis équipé d’un iPad et d’un iPod Touch 
reconditionnés, et je dois dire que je m’en félicite tous les jours. :-) 



Une brève histoire d’Apple 

À l’origine d’Apple, deux amis : Steve Wozniak et Steve Jobs. Le premier est un électro- 
nicien et un programmeur de génie. Le deuxième est un visionnaire qui saura imposer 
la marque à la pomme en lui conférant une simplicité d’utilisation et une ligne uniques. 
Steve Jobs est l’instigateur de cinq évolutions majeures dans le monde de l’informatique 
personnelle : 

- l’Apple II ; 

- le Macintosh ; 

- l’iPod ; 

- l’iPhone ; 

- l’iPad. 
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C’est courant 1975 que naît l’Apple I dans le garage de Steve Jobs. Rencontrant un suc- 
cès mitigé mais suffisant, il apporte suffisamment de capitaux pour que Steve Wozniak 
se consacre à temps plein à son digne successeur, l’Apple IL Cette machine révolu- 
tionnaire conquiert un large public grâce à ses innovations majeures, notamment un 
affichage texte et graphique, un interpréteur BASIC, le tableur VisiCalc et un lecteur 
de disquettes ! 

Début 1984, le grand public découvre le premier modèle de Macintosh. C’est encore à 
Steve Jobs que l’on doit ce beau succès commercial. Son design innovant, sa compa- 
cité, son écran graphique de grande qualité, sa simplicité d’utilisation et. . . sa souris 
révolutionnent l’utilisation de l’ordinateur. Le succès est immédiat et perdure depuis 
lors. 

Mais l’aventure ne s’arrête pas là : en 2001 naît l’iPod, en 2007 l’iPhone et en 2010 
l’iPad. Bien sûr, l’iPod n’est pas le premier baladeur MP3, l’iPhone n’est pas le premier 
téléphone cellulaire et l’iPad n’est pas la première tablette tactile. Par contre, ces trois 
périphériques sont vraiment simples à utiliser, et c’est ce qui fera leur succès. Une fois 
encore, Steve Jobs a su flairer le marché et adapter ce qui a fait le succès d’Apple : la 
simplicité d’utilisation et la ligne esthétique. 

Aujourd’hui, Steve Jobs n’est plus avec nous, mais son empreinte demeure indélébile 
dans la galaxie Apple ! 


Les iPhone, iPod Touch et iPad 

L’iPhone 


Les iPhone (figure 1.5) sont en tout point comparables aux iPod Touch, si ce n’est 
qu’ils permettent de téléphoner. Vous pouvez donc les utiliser pour : 

- joindre un correspondant par téléphone; 

- écouter de la musique ; 

- prendre des photos (à partir de l’iPhone 3) ; 

- joindre un autre utilisateur d’iPhone/iPod Touch/iPad en visioconférence (à partir 
de l’iPhone 4) ; 

- exécuter les applications écrites pour les iPhone. 



Avec l’assistant vocal des iPhone 4S, vous pouvez dicter des ordres à votre 
téléphone. Ainsi, vous pouvez prendre un rendez-vous, demander la météo, 
ajouter une alarme, etc. ... en parlant simplement à votre téléphone. Atten- 
tion, cet assistant n'est disponible que sur les modèles 4S. 
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Figure 1.5 - L’iPhone 


iPod Touch 

Les iPod Touch (figure 1.6) sont équipés d’un écran tactile de 3,5 pouces de diagonale. 
Ils peuvent être utilisés pour : 

- écouter de la musique ; 

- prendre des photos (à partir de l’iPod Touch 4) ; 

- joindre un autre utilisateur d’iPhone/iPod Touch/iPad en visioconférence (à partir 
de l’iPod Touch 4) ; 

- exécuter les applications écrites pour les iPhone. 




r 
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Figure 1.6 - L’iPod Touch 
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iPad 


Les iPad (figure 1.7) sont en gros des iPod Touch un peu plus grands. Ils peuvent donc 
être utilisés pour : 

- écouter de la musique ; 

- prendre des photos (à partir de l’iPad 2) ; 

- joindre un autre utilisateur d’iPhone/iPod Touch/iPad en visioconférence (à partir 
de l’iPad 2) ; 

- exécuter toutes les applications écrites pour les iPhone ainsi que les applications 
propres à l’iPad. 



Figure 1.7 - L’iPad 


La grande taille de l’affichage les rend également plus agréables que les iPod Touch ou 
les iPhone pour surfer sur le Web et lire des e-books et autres fichiers PDF. 

Vous avez maintenant une idée des possibilités offertes par les appareils mobiles Apple. 
Une question cruelle va se poser à vous : de quel(s) appareils ) devez- vous vous équiper ? 

Le mieux serait d’avoir un iPhone, un iPod Touch et un iPad. Vous pourriez ainsi 
développer pour ces trois périphériques et toucher un vaste public. Notez cependant 
que les différences entre l’iPod Touch et l’iPhone sont très réduites : grossièrement, le 
premier est équivalent au second, excepté qu’il ne peut pas être utilisé pour téléphoner. 

Un bon choix consiste donc à acheter : 

- un iPhone et un iPad si vous avez l’utilité d’un téléphone mobile ; 

- un iPod Touch et un iPad si vous n’avez pas l’utilité d’un téléphone mobile ; 

- un iPhone ou un iPod Touch si vos applications ne sont pas destinées aux tablettes 
iPad. 


9 



CHAPITRE 1. L’EQUIPEMENT DU CODEUR 


Limitations des appareils mobiles Apple 

Les appareils mobiles Apple sont limités par : 

- la taille de l’affichage : 

- 480 x 320 pixels : iPod Touch 3 et iPhone 3 ; 

- 960 x 640 pixels : iPod Touch 4 et iPhone 4 ; 

- 1024 x 768 pixels : iPad 1 et 2 ; 

- 2048 x 1536 pixels : iPad 3 ; 

- la quantité de mémoire vive disponible : 

- 128 Mo : iPod Touch 3 avec 8 Go de mémoire flash ; 

- 256 Mo : iPod Touch 3 avec plus de 8 Go de mémoire flash, iPod Touch 4, iPhone 
3 et iPad 1 ; 

- 512 Mo : iPhone 4 et iPad 2 ; 

- dans une moindre mesure, le type et la vitesse du processeur. 

La taille de l’affichage est un facteur déterminant. Elle conditionnera la mise en page 
de vos applications et devra s’adapter aux tailles caractéristiques des différents appa- 
reils mobiles. La quantité de mémoire vive est assez limitée. C’est pour cela qu’il est 
absolument nécessaire de tester une application sur un périphérique physique avant 
de la rendre disponible sur l’Apple Store. 

Le type et la vitesse du processeur n’influent qu’assez peu sur la vitesse d’exécution 
des applications. Ils ne seront pris en compte que dans le cas de jeux manipulant un 
grand nombre d’éléments graphiques. 


Et la programmation dans tout ça? 

Qu’est-ce qu’un programme ? 

Les ordinateurs, les téléphones, les tablettes graphiques et, d’une certaine manière, 
tous les appareils numériques, utilisent des programmes (appelés aussi applications) 
pour accomplir des tâches bien précises. Ainsi par exemple, lorsque vous démarrez 
votre traitement de texte, votre navigateur Web ou votre messagerie, vous utilisez 
un programme. Autour de ces programmes, un « super programme », appelé système 
d’exploitation, joue le rôle de chef d’orchestre et permet aux applications d’accéder au 
matériel sur lequel elles s’exécutent. On dit qu’il sert d’interface entre le matériel et les 
programmes. À titre d’exemple, Microsoft Windows et Mac OS X sont des systèmes 
d’exploitation. 

Selon le matériel et le système d’exploitation utilisés, les applications sont écrites en 
utilisant un ou plusieurs langages de programmation. Les iPhone, iPod Touch et iPad 
sont orchestrés par un système d’exploitation identique. Pour écrire des applications 
destinées à ce système, un seul langage de programmation peut être utilisé : Objective- 
C. 
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ET LA PROGRAMMATION DANS TOUT ÇA ? 


Connaissances préalables nécessaires pour programmer 

Vous êtes en train de lire un Livre du Zéro, et à ce titre, et pour ne pas déroger à la 
règle, aucune connaissance préalable n’est nécessaire! Ceci étant dit, si vous avez déjà 
une première expérience de la programmation orientée objet ou du langage Objec.tive- 
C, ce sera un vrai plus : vous comprendrez très rapidement bon nombre de notions 
qui seront évoquées ici et vous serez très vite capables de passer à la pratique. Si vous 
n’avez jamais programmé, ne vous en faites surtout pas ! Je serai votre guide tout au 
long de votre apprentissage. Pour peu que vous ayez un peu de temps, d’intérêt, de 
passion et de persévérance, vous progresserez très vite. 


Langages, API et système 

Tout au long de ce tutoriel, nous allons souvent parler d’Objective-C, de Cocoa 
Touch et d’iOS. Il est temps pour moi de vous présenter ces termes. 

- Objective-C est le langage de programmation utilisé pour développer des applica- 
tions pour iPhone, iPod Touch et iPad. Il s’agit d’un langage hérité du langage C, 
c’est-à-dire que l’Objective-C emprunte au C bon nombre de choses. 

- Cocoa Touch est une API 1 dédiée à l’écriture d’applications pour iPhone, iPod 
Touch et iPad. Une API est constituée d’un ensemble de programmes pré-écrits 
(classes et méthodes dans le jargon des spécialistes). Cocoa Touch ne déroge pas à la 
règle ; elle est spécifiquement développée pour les devices Apple. Elle est accessible 
à travers Xcode, le logiciel de développement que nous utiliserons. 

iOS est le système d’exploitation des iPhone/iPod Touch/iPad. 

Vous trouverez à la figure 1.8 un schéma pour vous aider à visualiser tout ce petit 
monde. 



Langage Objective-C 



Figure 1.8 - Nous aurons besoin du langage Objective-C et de Cocoa Touch pour 
développer nos applications iOS 


1. Application Programming Interface ou, en français, interface de programmation. 
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CHAPITRE 1. L’EQUIPEMENT DU CODEUR 


Combien de temps me faudra-t-il pour écrire ma première application? 


Les réponses à cette question sont multiples. Si tous les logiciels nécessaires sont instal- 
lés et si vous voulez juste créer votre première application sans vraiment comprendre 
ce que vous faites, dix minutes sont suffisantes ! 

Si rien n’est encore installé (je suppose quand même que vous avez un Mac sous la 
main), comptez trois à quatre heures pour installer le logiciel et mettre au point une 
application qui affiche un texte sur votre device. 

Je vous conseille cependant de ne pas compter le temps passé : vous vous lancez dans une 
grande aventure. Il vous faudra du temps (beaucoup de temps même) pour comprendre 
les mécanismes de la programmation Objective-C, mais cela en vaut la peine! Une fois 
les mécanismes de base assimilés, vous pourrez réaliser tout ce qui vous vient en tête. . . 



Les logiciels nécessaires 

Xcode sur votre Mac 

Xcode est le programme que vous utiliserez pour développer vos applications. La version 
utilisée dans ce tutoriel est la 4.2 (sous OS X Lion 10.7.2). Si vous utilisez une autre 
version, quelques détails différeront, mais la plupart de ce qui sera dit restera valable. 
Par défaut, Xcode est normalement déjà installé sur votre Mac. Pour vous en assurer, 
cliquez sur l’icône du Finder, à l’extrême gauche du dock. Cette action ouvre une fenêtre 
dans laquelle sont affichés vos principaux dossiers, comme le montre la figure 1.9. 



^ (J) (v) 0 ^ ÎEI 


Figure 1.9 - Affichage des principaux dossiers du Mac 
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LES LOGICIELS NÉCESSAIRES 


Dans le volet de gauche, sous APPAREILS, cliquez sur Macintosh HD. Dans le volet de 
droite, double-cliquez sur Développer, sur Applications, puis sur Xcode. Une boîte 
de dialogue est alors affichée, comme à la figure 1.10. 



Figure 1.10 - Une boîte de dialogue Xcode s’affiche 


La version du logiciel est affichée juste en dessous du titre « Welcome to Xcode ». Ici, 
il s’agit de la version 3.2.6. Si votre version de Xcode n’est pas au moins égale à la 
4.2, je vous conseille vivement de télécharger puis d’installer la toute dernière version 
disponible. Pour cela, vous devez rejoindre la communauté des développeurs Apple. 
Rassurez- vous, cette opération est entièrement gratuite. Connectez-vous sur la page 
d’enregistrement d’Apple, cliquez sur Get Started et suivez la procédure indiquée 
pour rejoindre la communauté des développeurs. 

[Rejoindre la communauté 

l Code web : 403043 , 


Si vous ne savez pas comment utiliser les codes web, je vous renvoie à la page 
iii de l'avant-propos de ce livre, vous trouverez la marche à suivre. 



Une fois enregistrés, connectez-vous sur la page de téléchargement de Xcode, cliquez 
sur Log in et connectez-vous en utilisant votre identifiant Apple ID. 


[Télécharger Xcode 


[Code web : 270285 

) 


Attention, toutes les versions de Xcode ne sont pas compatibles avec toutes les versions 
du système d’exploitation OS X. À vous d’installer la version appropriée : 
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CHAPITRE 1. L’EQUIPEMENT DU CODEUR 


- Léopard : Xcode 3.1 ; 

- Snow Léopard : Xcode 3.2 ou 4.0 ; 

- Lion : Xcode 4.2. 

Et surtout, armez-vous de patience : le fichier à télécharger pèse quelque 4 Go ! 



La version 4.0 de Xcode est disponible pour les membres du programme de 
développement (99 dollars par an), mais également sur l’App Store pour la 
modique somme de 3,99 euros. Quant à la version 4.1 de Xcode, elle est 
disponible gratuitement sur l’App Store. 


Installation de Xcode 

Dans l’exemple qui va suivre, je me suis basé sur Xcode 4.2 sous OS X Lion. 
Si vous installez une autre version, il se peut que vous n’ayez pas exactement 
la même chose que moi, mais le principe reste le même. 

Une fois Xcode téléchargé, une icône d’installation est affichée dans le dock, comme à 
la figure 1.11. 

pj y i » ^ il j V iPUi'i.iii ii»V < « V „i f 


Figure 1.11 - L’icône d’installation de Xcode apparaît dans le dock 

Cliquez sur l’icône Install Xcode. Cette action ouvre la fenêtre Install Xcode. Cli- 
quez sur Install, sur Agréé, entrez votre nom et votre mot de passe puis patientez 
jusqu’à la complète installation du programme. Une fois l’installation terminée, l’icône 
Install Xcode du dock se transforme en Xcode. Il suffit de cliquer dessus pour accéder 
à Xcode. 



En résumé 

- Les développements pour iPhone, iPod Touch et iPad se font sur un Mac équipé d’un 
processeur Intel. 

- Pour développer des applications pour iPhone, iPod Touch et iPad, vous utiliserez 
l’application Xcode, normalement déjà installée sur votre Mac. Si tel n’était pas le 
cas, vous pouvez télécharger Xcode depuis le site pour développeurs d’Apple. 

- Pour utiliser la dernière version de l’application Xcode (4.2.x), le Mac doit utiliser 
le système d’exploitation OS X Lion ou supérieur. 
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Chapitre 



Un premier développement 


Difficulté : — 

L e but de ce premier développement est de vous faire prendre contact avec Xcode et 
le langage Objective-C. N'essayez pas de comprendre tout ce qui va être dit ici : cela 
deviendra de plus en plus clair au fur et à mesure de votre apprentissage. 

Vous verrez, cette première application sera vraiment très basique. Un clic sur l'écran 
remplacera un texte par un autre. Ça n'a l'air de rien dit comme ça, mais ce n'est déjà pas 
si mal. 
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CHAPITRE 2. UN PREMIER DEVELOPPEMENT 


Création de l’application 


Avant toute chose, il nous faut lancer Xcode, en cliquant par exemple sur l’icône pré- 
sente dans le dock (figure 2.1). 



Figure 2.1 - L’icône de Xcode dans le dock 


La fenêtre Welcome to Xcode s’affiche alors, comme à la figure 2.2. 


« 



Welcome to Xcode 

Version 4.2 (4D199) 


m 

L 

© 


Create a new Xcode project 

Start building a new Mac. iPhone or iPad 
application from one of the induded templates 

Connect to a repository 

Use Xcode's integrated source control features to 
work with your existlng projects 

Learn about using Xcode 

Explore the Xcode development environment with 
the Xcode 4 User Guide 

Go to Apple's developer portai 

Visit the Mac and iOS Dev Center websites at 
developer.apple.com 



| Open Other Show this window when Xcode launches 


[ Cancel J [ Open ] 


Figure 2.2 - Fenêtre de lancement de Xcode 

Nous allons ensuite créer un nouveau projet. Pour cela, rien de plus simple, il vous suffit 
de cliquer sur Create a new Xcode project. Une nouvelle boîte de dialogue s’affiche 
(figure 2.3). Dans le volet de gauche, sous iOS, choisissez Application. Dans la partie 
centrale de la boîte de dialogue, choisissez Single View Application. 

Cliquez sur Next, donnez le nom « premier » au projet, tapez « test » dans la zone 
de texte Company Identifier, sélectionnez iPhone dans la liste Device Family, et 
cochez la case Include Unit Tests, comme indiqué à la figure 2.4. 

Cliquez sur Next et choisissez le dossier dans lequel le projet sera créé (figure 2.5), au 
besoin en cliquant sur New Folder pour créer un nouveau dossier. 

Cliquez sur Create. Le projet est alors créé et ouvert dans Xcode, comme à la figure 

2 . 6 . 
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CRÉATION DE L APPLICATION 


Choose a template for your new project: 


Il 'OS 



Framework & Library 
Other 


Mac OS X 

Application 
Framework & Library 
Application Plug-in 
System Plug-in 
Other 


““ 

i y 



if î§> 


Master-Detail 

OpenCL Came 

Page-Based 

Application 

X 

Application 

Tabbed Application 

Utility Application 

Empty Application 



Single View Application 

This template provides a starting point for an application that uses a single view. It provides a 
view controller to manage the view, and a storyboard or nib file that contains the view. 



Previous | Next 


Figure 2.3 - Création d’un nouveau projet dans Xcode 


Choose options for your new project: 



Product Name premier 
Company Identifier test 

Bundle Identifier test.premier 


Class Prefix XYZ 
Device Family [ iPhone 


^ Use Storyboard 

0 Use Automatic Reference Counting 
Include Unit Tests 


Figure 2.4 


Les options du nouveau projet 
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CHAPITRE 2. UN PREMIER DEVELOPPEMENT 


■« f» |l SS 1=1 ŒD !»H SS » H Bureau î Q. 


FAVORITES 

1S1 Tous mes fi... 

2 michelmartin 
Applications 

Documents 

DEVICES 

i, - , Macintosh HD 
liJ SAUVEG... ± 

Name Date Modified 

► CJ resource 20 oct. 2011 20:19 

► Q rest 9 août 2011 15:45 

► Q retest 11 août 2011 13:51 

► Voiture 9 juin 2011 09:39 




Source Control: 0 Create local git repository for this project 

Xcode will place your project under version control 


| New Folder | | Cancel | [ Create | 


Figure 2.5 - Il faut choisir l’emplacement du projet 



Figure 2.6 - Le projet est créé et ouvert 
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AJOUT DES CONTRÔLES SUR L'INTERFACE 


Cette fenêtre va vous permettre de définir l’allure de l’application, de saisir du code 
Objective-C et de tester l’application. Pour l’instant, nous n’allons pas entrer dans les 
détails de la fenêtre de Xcode, cela ne ferait que vous embrouiller. 

Vous vous demandez peut-être pourquoi avoir choisi une application de type 
Single View, ou encore pourquoi avoir tapé « test » dans la zone de texte 
Company Identifier. Ces deux questions resteront pour l'instant sans ré- 
ponse. Plutôt que de tout introduire en même temps et de vous noyer sous 
des détails qui ne manqueraient pas de s'entremêler dans votre tête, j'ai choisi 
de ne pas répondre pour l'instant à ces deux questions. . . qui sont toutefois 
bien légitimes. 


Ajout des contrôles sur l’interface 

La première étape va consister à dessiner ce que l’on souhaite voir s’afficher sur l’écran 
du device 1 . L’interface de Xcode est composée de plusieurs modules (éditeur de code, 
zone de débogage, utilitaires, éditeur d’interface, etc.). Chacun d’entre eux utilise un 
ou plusieurs volets, accessibles à partir de la zone de navigation ou de la barre d’outils. 
Dans cette première étape, vous allez utiliser Interface Builder pour construire la 
partie visuelle de l’application. Pour ce faire, procédez selon les trois étapes suivantes 
en vous aidant au besoin de la figure 2.7. 

1. Dans la zone de navigation, cliquez sur MainStoryboard. storyboard (1) pour 
accéder à Interface Builder. 

2. Dans la barre d’outils, cliquez sur l’icône Hide or Show the utilités (2), au- 
dessus du libellé View, pour révéler le volet des utilitaires. 

3. Dans la partie inférieure du volet des utilitaires, cliquez sur l’icône Show the 
Object library (3) pour afficher la bibliothèque d’objets. Cliquez si nécessaire 
sur l’icône Icon View (4) pour afficher plus de contrôles dans la bibliothèque 
d’objets. 

Glissez-déposez un contrôle Label de la bibliothèque d’objets dans la zone d’édition. Si 
vous n’êtes pas (encore) familiers avec cette opération, sachez qu’elle consiste à cliquer 
sur le contrôle Label dans la bibliothèque d’objets, à maintenir le bouton gauche de 
la souris enfoncé, à déplacer l’élément ainsi sélectionné au-dessus de la zone d’édition 
puis à relâcher le bouton de la souris, comme le montre la figure 2.8. 

Glissez-déposez ensuite un contrôle Round Rect Button (un bouton) de la bibliothèque 
d’objets dans la zone d’édition, comme indiqué à la figure 2.9. 

Vous allez maintenant modifier le texte affiché par défaut dans le Label. Double-cliquez 
sur celui-ci dans la zone d’édition, écrivez « Cliquez sur le bouton » puis appuyez sur la 

1. Je vous rappelle que device désigne le périphérique sur lequel s’exécutera l’application; il peut 
tout aussi bien s’agir d’un iPhone, d’un iPod Touch ou d’un iPad. Ici, la cible de l’application étant 
un iPhone ou iPod Touch, device désigne ces deux périphériques. 
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CHAPITRE 2. UN PREMIER DEVELOPPEMENT 



Figure 2.7 - Affichage de la bibliothèque d’objets 



Fil* Type I Default - Interface Bu... : 
Location | Relative to Croup : 

Nooe □ 

Full Path /Users/michelmartin/ 
Desktop/premier/ 
premier 

Dev Région /Users/michelmartin/ 
Oesktop/premler/ 
premier/en. IproJ / 
MainStoryboard . storybo 
ard 

▼ Interface Builder Document 
Document Vertioning 
Deployment | Project SDK Version (l ... * 


Development | Default Version (Xcod » 


Localisation Locking 
Default [ Nothing 


Reset Locking Controls 


▼ Localisation 


D {} 


liii Objects 


-8 


Ü 6 0 


View Controller 


1 2 


Figure 2.8 - Glisser-déposer un contrôle Label 
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AJOUT DES CONTRÔLES SUR L'INTERFACE 



Figure 2.9 - Le contrôle Round Rect Button 


touche ( Entrée ) de votre clavier. Faites de même pour afficher un texte sur le bouton : 
double-cliquez sur le bouton, écrivez « Cliquez ici » et appuyez sur la touche | Entrée ) . 
La zone d’édition doit maintenant ressembler à la figure 2.10. 


Cliquez sur le boulon 

Y ' 

Cliquez ici ]- 


Figure 2.10 - La zone d’édition que vous devriez avoir 
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CHAPITRE 2. UN PREMIER DEVELOPPEMENT 


Liaison des contrôles au code 


Cette application doit afficher un texte dans le Label lorsque l’utilisateur clique sur le 
bouton. Pour que le code Objec.tive-C puisse agir sur les contrôles définis dans l’étape 
précédente, il faut relier les contrôles au code. 

Cliquez sur l’icône Show the Assistant editor, au-dessus du libellé Editor, dans la 
partie droite de la barre d’outils (figure 2.11). Cette action affiche le code du fichier 
ViewController .h dans un volet vertical. 



Show the Assistant editor 


ni Bi h l ma □ je 

Editor View Organizer 


Figure 2.11 - L’icône Show the Assistant editor 

Si votre écran n’est pas assez large pour visualiser la zone d’édition et le code, désac- 
tivez la zone d’utilitaires en cliquant sur l’icône Hide or Show the Utilities, dans 
la partie droite de la barre d’outils, au-dessus du libellé View (figure 2.12). 


Hide or Show the Utilities 


. 

Hamel ru- ai lmj 


View Organizer 


Figure 2.12 - L’icône Hide or Show the Utilities 
ViewController .h contient les déclarations relatives aux objets manipulés. 

Déclarations, objets? Je n'y comprends rien ! 


Les applications développées avec Xcode sont composées de nombreux fichiers. Certains 
ont un nom qui se termine par .h, comme par exemple ViewController .h dans le cas 
qui nous intéresse. Ces fichiers sont dits fichiers d’en-têtes. Ils contiennent des ins- 
tructions Objective-C qui permettent d’identifier les objets (c’est-à-dire les contrôles 
déposés sur la zone d’édition depuis Interface Builder) utilisés dans l’application. Ces 
instructions sont appelées déclarations. 

Pour ajouter les déclarations nécessaires pour le Label, contrôle-glissez-déposez le 
contrôle Label du volet d’édition dans le volet de code, juste au-dessus de la dernière 
ligne (figure 2.13). Cette technique deviendra vite habituelle. Elle consiste à : 

1. placer le pointeur de la souris sur le contrôle Label dans le volet d’édition ; 


Le fichier 

e 


22 


LIAISON DES CONTRÔLES AU CODE 


2. maintenir la touche ( Ctrl ) de votre clavier enfoncée ; 

3. maintenir le bouton gauche de la souris enfoncé et déplacer le contrôle Label 
du volet d’édition dans le volet de code, juste au-dessus de la ligne où apparaît 
l’instruction @end ; 

4. relâcher le bouton gauche de la souris ainsi que la touche [ Ctrl ). 



El M - M V. V. View Label - Cliquez sur le bouton 

S;; i ◄ ► Ü h ViewContr. No Sélection ^ 2 ► O 0 


Cliquez sur le bouton 
Cliquez ici 


// Created by Michel Martin on 24/16/11. 

// Copyright < c ) 2011 MyCofltpanyName . Ail 

nghts reserved. 


«iaport «UXKit/UIKit.h» 

^interface ViewController : UlViewCont roller 


Insert Outlet or Outlet Collection 


Figure 2.13 - Un simple contrôle-glisser-déposer permet d’ajouter des déclarations 
dans le volet d’édition 


Au relâchement du bouton gauche de la souris, une boîte de dialogue est affichée. Tapez 
« message » dans la zone de texte Name, comme à la figure 2.14. 



OB'] 

Connection Outlet 

— S) 1 

Object O View Controller 

Name [message 

^ Type [ UILabel 

0 ff 

Storage Weak 


Cancel ) 

Connect 



™ 

TTl 


// Copyright (c) 2011 MyCompanyName . Ail 

rights reserved. 

// 

#import <UIKit/UIKit.h> 

^interface ViewController : UlViewCont roller 
@end 


Figure 2.14 - Une boîte de dialogue s’affiche au relâchement du bouton de la souris 

Cliquez sur Connect. Le code du fichier ViewController .h devrait maintenant res- 
sembler à ceci : 


# import <UIKit/UIKit ,h> 
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CHAPITRE 2. UN PREMIER DÉVELOPPEMENT 


3 ^interface ViewController : UlViewController 

4 

5 Sproperty (weak , nonatomic) IBOutlet UILabel ^message; 

6 

7 Oend 

Passons quelques minutes sur ce code si vous le voulez bien. 

La première ligne, sur laquelle figure le mot import, fait référence à tout ce dont 
vous aurez besoin pour développer une interface utilisateur pour périphérique iOS. 
En ajoutant cette simple ligne au début de l’application, le code pourra afficher sur 
l’écran du device et répondre aux gestuelles (appui, déplacement, rotation, etc.) des 
utilisateurs. 

La ligne 3, sur laquelle figure le mot interface, indique que l’application ViewController 
est de type UlViewController : 

l| ^interface ViewController : UlViewController 

La ligne 5, qui contient le mot property, indique le comportement de l’objet : 
l| Sproperty (weak, nonatomic) IBOutlet UILabel ^message; 

O Pour l'instant, ne vous préoccupez pas des paramètres qui font suite au mot 
interface. Ces paramètres sont générés automatiquement par Xcode et leur 
valeur importe peu pour l'instant. Nous y reviendrons un peu plus loin dans 
ce livre. 

Enfin, la ligne 7 matérialise la fin du fichier ViewController .h : 

l | Oend 

Contrôle-glissez-déposez le bouton de la zone d’édition dans le volet de code, juste 
au-dessus de la dernière ligne, comme à la figure 2.15. 

I // Created by Michel Martin on 24/10/11. 

35 } // Copyright (c) 2011 MyCompanyName . Ail 

rights reserved. 

// 

«împort <UIKit/UIKit.h> 

^interface ViewController : UlViewController 

• Qproperty (weak, nonatomic) IBOutlet UILabel 
«message; 


Insert Outlet. Action, or Outlet Collection 


çend 


Figure 2.15 - Un contrôle-glisser-déposer au-dessus de la dernière ligne de code 


Cliquez sur le bouton 
Cliquez ici • 


q À 
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ECRITURE DU CODE 


Au relâchement du bouton de la souris, une boîte de dialogue est affichée. Ici, nous 
voulons associer une action au bouton, afin qu’un message soit affiché dans le Label 
lorsque l’utilisateur appuie sur le bouton. Choisissez Action dans la liste déroulante 
Connection et tapez « reagir » dans la zone de texte Name. La boîte de dialogue devrait 
maintenant ressembler à la figure 2.16. 


uez sur le bouton 


n 

U 


Connection Action 

îji 

Object O View Controller 


Name 1 reagir) 

U 

Type 1 Id 

~]T] 

Event Touch Up Inside 

Q 

Arguments Sender 

Q 


Qproperty (wea 
«message; 


@end 


Canctl 1 Connect 

I 1 'If 


Figure 2.16 - La boîte de dialogue permet d’associer une action au bouton 


Comme vous pouvez le voir sur cette image, l’action reagir (paramètre Name), exécutée 
lorsque l’utilisateur appuie sur le bouton (Touch Up Inside, soit « au relâchement du 
bouton de la souris » dans le paramètre Event), est sur le point d’être définie. 

Cliquez sur Connect. Le code est complété avec une nouvelle instruction : 


î 

2 

3 

4 

5 

6 

7 

8 
9 


# import CUIKit/UIKit .h> 

©interface ViewController : UlViewController 
©property (weak , nonatomic) IBOutlet UILabel ♦message; 
- ( IBAction) reagir :( id) sender ; 

©end 


Comme vous pouvez le voir, une ligne a été ajoutée dans le code pour déclarer l’action 
reagir dans le code (ligne 7). 


Écriture du code 

Cliquez sur l’entrée ViewController .m dans le volet de navigation. Un code assez 
imposant apparaît dans la partie centrale de la fenêtre. Il a (gentiment) été généré par 
Xcode. 

1 // 

2 // ViewController . m 

3 // premier 

4 // 

5 // Created by Michel Martin on 24/10/11. 

6 // Copyright (c) 2011 __MyCompanyName__ . Ail rights reserved. 
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HAPITRE 2. 


UN PREMIER DÉVELOPPEMENT 


II 


#import " Vi ewCont r o lier . h " 

@ implement at ion ViewController 
Ssynthesize message; 

- ( void) didRecei veMemoryWarning 

{ 

[super didReceiveMemoryWarning] ; 

// Release any cached data, images , etc that aren ' 

} 


#pragma mark - View lifecycle 


- ( void) viewDidLoad 

{ 

[super viewDidLoad]; 

// Do any additional setup after loading the view, 
f rom a nib . 

} 

- ( void) viewDidünload 

{ 

[self setMessage : nil] ; 

[super viewDidünload]; 

// Release any retained subviews of the main view. 
// e.g. self . myOut let = nil; 

} 

- (void) viewWill Appear : (B00L) animated 

{ 

[super viewWillAppear : animated] ; 

} 

- (void) viewDidAppear : (B00L) animated 

{ 

[super viewDidAppear : animated] ; 

} 

- (void) viewWillDis appear : (B00L) animated 

{ 

[super viewWillDisappear : animated] ; 

} 


- (void) viewDidDisappear : (B00L) animated 

{ 

[super viewDidDisappear : animated] ; 

} 


t in use . 
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- (B00L) shouldAutorotateToInterfaceOrientation : ( 

UI Interface Orientât ion) interface Orientât ion 

{ 

// Return YES for supported orientations 
return ( inter f aceûrientat ion != 

UIInterfaceOrientationPortraitUpsideDown) ; 

} 

- ( IBAction) reagir :( id) sender { 

} 

®end 



Vous avez sans doute remarqué que certaines lignes de code ne sont pas 
alignées à gauche; c'est ce qu'on appelle indenter son code. Le but est 
d'améliorer la lisibilité du code en définissant visuellement sa structure. Vous 
pouvez utiliser des tabulations ou des espaces, selon votre préférence. 


Jetez un œil aux dernières lignes du code. Est-ce que cela ne vous rappelle rien ? La 
ligne 62 est la copie conforme de la déclaration qui a été générée lorsque vous avez 
contrôle-glissé-déposé le bouton de la zone d’édition dans le fichier ViewController .h. 
Avez- vous remarqué les accolades, juste après le mot sender? C’est à cet endroit que 
vous allez écrire le code qui permettra d’afficher un message dans le Label lorsque 
l’utilisateur clique sur le bouton. Complétez cette déclaration comme suit : 

1 - ( IBAction) reagir :( id) sender { 

2 NSString ♦lemessage = [[NSString alloc] initWithFormat : @ " 

Bravo ! " ] ; 

3 message. text = lemessage; 

4 } 


j Copier ce code 
1 Code web : 444818 


Mais qu'est-ce que tout ce charabia ? C'est comme ça que parle mon iPhone? 



Ce n’est pas comme ça que parle votre iPhone, mais plutôt comme ça qu’Objec.tive-C 
se fait comprendre de votre device. Je sais que la syntaxe de ces instructions a de quoi 
surprendre. Ne vous en faites pas, et surtout, n’essayez pas de tout comprendre tout 
de suite. Pour l’instant, contentez-vous de voir le mot « Bravo » sur la deuxième ligne. 
C’est ce mot qui sera affiché sur l’iPhone lorsque vous cliquerez sur le bouton. 


Construction et exécution 

Dans la barre d’outils, cliquez sur l’icône Run (figure 2.17). 
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Cliquez ici 


© o o 

( premier iPhone 5.0 Simulator 



// ViewController.m 
fl premier 
// 


Figure 2.17 - L’icône Run de la barre d’outils 


Ail bout de quelques instants, une fenêtre complémentaire nommée Simulateur iOS 
est affichée, et l’application apparaît dans son état initial. Cliquez sur le bouton. Le 
texte « Bravo! » remplace le texte « Cliquez sur le bouton », comme à la figure 2.18. 
Je vous félicite ! Vous venez de réaliser votre première application sur iPhone ! 



Avant l'appui sur le bouton 


Après l'appui sur le bouton 


Figure 2.18 - Votre première application iPhone ! 


En résumé 

- Le design des applications est défini dans la composante Interface Builder de l’appli- 
cation Xcode. 
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- La bibliothèque d’objets est accessible en cliquant sur l’icône Hide or Show the 
Utilities, puis sur l’icône Show the Object library. 

- Pour ajouter un contrôle dans une vue, il suffit de le glisser-déposer depuis la biblio- 
thèque d’objets dans le Storyboard. 

- Pour relier un contrôle au code, contrôle-glissez-déposez-le depuis le Storyboard 
dans le fichier .h correspondant et indiquez si vous voulez créer un outlet ou une 
action. 

- Le code de l’application est écrit dans le fichier .m qui correspond à la vue. 

- Pour construire et exécuter l’application dans le simulateur iOS, il suffit de cliquer 
sur l’icône Run, dans l’angle supérieur gauche de la fenêtre de Xcode. 
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îhapitre 


3 


Le simulateur iOS 


Difficulté : — 

L e simulateur iOS fait partie intégrante de Xcode. Cette application permet de simuler 
le fonctionnement d'un iPhone, d'un iPod Touch et d'un iPad. Que vous ayez rejoint la 
communauté des développeurs Apple ou non, vous utiliserez fréquemment le simulateur 
pour tester rapidement vos applications. Il est donc important de savoir l'utiliser. 

Dans le chapitre précédent, vous avez eu un premier contact avec le simulateur iOS. Dans 
ce chapitre, vous allez faire plus ample connaissance avec lui. Vous apprendrez entre autres 
à simuler les gestuelles de l'utilisateur, à installer et désinstaller une application et bien 
d'autres choses encore. 
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Les bases 

Lorsque vous définissez un nouveau projet Xcode, vous devez choisir un type de device : 
iPhone/iPod Touch ou iPad (figure 3.1). 


Choose options for your new project: 



Product Nam» | | 

Company Identifier test 

Bundle Identifier ’ ’U.ProductNamc 

Class Prefîx |xY2 | 

Ê Device Family iPhone î 

0 Use Storyboard 

(?ÿ Use Automatic Reference Counting 
1^ Include Unit Tests 

U 

Cancel ( Previous | Next 


Figure 3.1 - Xcode vous demande de choisir un type de device 

Si vous voulez utiliser le simulateur iOS, vous pouvez à tout moment changer de device 
en utilisant la liste déroulante Scheme, dans la partie supérieure gauche de la fenêtre 
de Xcode (figure 3.2). 



Figure 3.2 - Vous pouvez à tout moment changer le device du simulateur à partir de 
Xcode 

Une autre possibilité consiste à utiliser le menu du simulateur. La fenêtre de ce dernier 
étant en avant-plan, déroulez le menu Matériel, pointez Appareil et choisissez un des 
devices proposés, comme à la figure 3.3. 
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Débogage Fenêtre Aide 



Figure 3.3 - Le device peut également être choisi directement via le simulateur 


Le menu Matériel offre des possibilités complémentaires, puisqu’il est possible de 
simuler la version du système iOS (on dit aussi firmware) utilisé. Déroulez le menu 
Matériel, pointez Version et choisissez la version d’iOS à utiliser, comme à la figure 
3.4. 



Figure 3.4 - Il est également possible de choisir la version d’iOS 



Cette commande est très pratique pour s'assurer qu'une application fonc- 
tionne bien sur toutes les versions du firmware. 


Une fois le simulateur iOS choisi comme cible de l’application, cliquez sur le bouton 
Run pour lancer l’application dans le simulateur. 


Simuler les gestuelles et les actions de l’utilisateur 


Le simulateur iOS est une application Mac. Il s’exécute dans une fenêtre affichée sur 
l’écran relié à votre ordinateur. Etant donné que cet écran est une simple dalle réservée 
à l’affichage, il n’est pas capable de réagir aux gestuelles ni aux actions effectuées sur 
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un iPhone/iPod Touch/iPad. Toutefois les ingénieurs en charge du développement de 
cette application ont eu la bonne idée de lui associer des raccourcis clavier pour simuler 
les gestuelles et les actions des utilisateurs. 


Simuler les gestuelles de l’utilisateur 

Vous vous en doutez, il n’est pas possible de faire tourner votre écran d’ordinateur ou 
de le secouer pour simuler ces actions dans le simulateur iOS. Par contre, vous pouvez 
utiliser des commandes dans le menu Matériel du simulateur iOS, ou les raccourcis 
clavier équivalents. 


Action 

Commande dans 
le menu Matériel 

Raccourci 

Rotation d’un quart de 
tour à gauche 

Rotation à gauche 

Commande + Gauche 

Rotation d’un quart de 
tour à droite 

Rotation à droite 

Commande + Droite 

Verrouillage 

Verrouiller 

Commande + L 

Secousse 

Secousse 

Ctrl + Commande + Z 

Écran d’accueil 

Écran d’accueil 

Maj + Commande + H 


Simuler les actions de l’utilisateur 

Les actions liées au toucher (clic, double-clic, agrandir, etc.) peuvent également être 
simulées dans le simulateur iOS en utilisant la souris. 


Action sur le device 

Action dans le simulateur 

Toucher 

Cliquez. 

Toucher et maintenir 

Maintenez le bouton gauche enfoncé. 

Feuilleter 

Placez le pointeur sur l’objet à déplacer, maintenez le 
bouton gauche enfoncé, déplacez l’objet puis relâcher le 
bouton gauche. 

Glisser-déposer 

Placez le pointeur sur l’objet à déplacer, maintenez le 
bouton gauche enfoncé, déplacez l’objet puis relâchez le 
bouton gauche. 

Zoom avant, zoom arrière 

Maintenez la touche Option enfoncée. Deux ronds semi- 
opaques apparaissent sur l’écran. Maintenez le bouton 
gauche de la souris enfoncé et déplacez la souris dans la 
direction souhaitée pour obtenir le redimensionnement. 
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Quelques pratiques à connaître 


Installer/désinstaller une application 


Pour installer une application, il suffit de l’exécuter dans le simulateur en cliquant sur 
le bouton Run de Xcode. Elle est alors disponible sur l’écran des applications (figure 
3.5), et le restera jusqu’à ce que vous la désinstalliez. 



Figure 3.5 - Il est possible d’installer des applications dans le simulateur 

Pour désinstaller une application, pointez son icône et maintenez le bouton gauche de 
la souris enfoncé jusqu’à ce que toutes les icônes se mettent à bouger. Cliquez alors sur 
la case de fermeture de l’application que vous voulez désinstaller (figure 3.6). 



Si vous n'avez plus l'intention de désinstaller une application, il vous suffit 
de cliquer sur le bouton principal, en bas du simulateur pour arrêter la danse 
des icônes. 


Retourner à la configuration d’usine 

Une commande permet de réinitialiser le simulateur iOS pour lui redonner sa configura- 
tion d’usine, c’est-à-dire sa configuration juste après l’installation de Xcode. Toutes les 
applications installées, contenus et réglages sont supprimés et placés dans la corbeille 
du Mac. Pour réinitialiser votre simulateur iOS, cliquez sur le menu Simulateur iOS 
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r 




Carrle» 4:25 PM 




SM 


□ 



Figure 3.6 - La croix permet de désinstaller une application du simulateur 


et sélectionnez Réinitialiser le contenu et les réglages. Une boîte de dialogue 
de confirmation est affichée. Cliquez sur Réinitialiser pour confirmer votre choix. 


Déboguer une application lors de son exécution sur le simulateur 

L’application Xcode est dotée d’un volet de débogage, aussi appelé « console ». Ce volet 
permet d’afficher des informations textuelles pendant qu’une application s’exécute, 
et ce, quelle qu’en soit la cible : le simulateur iOS ou un device réel. Cette section 
est une première approche du débogage. N’ayant pas encore abordé l’exécution d’une 
application sur un device, vous allez apprendre à afficher des données dans la console 
pendant l’exécution sur le simulateur iOS. 

Pour afficher le volet de débogage, il suffit de cliquer sur l’icône Hide or show the 
Debug area, dans la barre d’outils de Xcode (figure 3.7). 

Vous utiliserez une instruction, NSLogO, pour afficher des informations dans le volet 
de débogage : 

l| NSLog(@"Le texte à afficher"); 

Comme vous pouvez le voir sur la figure 3.7, l’instruction NSLogO affiche le texte 
« Bonjour » dans le volet de débogage (à la dernière ligne). 
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Cliquez ici , 



( votd) viewOidDitappear: (BOOL)onixated 
Ituper viewOidOisappear :ani«ated| ; 


( IBAct Ion) i 
NSStnng 


eagir: ( ldliender { 

leueuage = [(NSString alloc] lnitWithFornat:f"Bravo !"J; 


age.text = lenessage; 


Le volet de déboguage 


t£l II 

Local î 






Cltar 


stribute copies of it under 


Ail Outpul î 

ticenîf , »no you are 
welcoise to change it i 
certain conditions. 

Type "show copying" to see the conditions. 

There is absolutely no warranty for GDB. Type ”sho« 
warranty" for details. 

This GDB was configured as "x8G_64-apple-darwin". 
Attaching to process 3471. 

2m-l*-24 16:31:29.64# praxiar 1 3471 : f 8#3 1 Bonjour 


Figure 3.7 - Le bouton Hide or show the Debug area permet d’afficher le volet de 
débogage 


En résumé 

- Le simulateur iOS fait partie intégrante de l’application Xcode. 

- La liste Scheme (dans l’angle supérieur gauche de la fenêtre de Xcode) permet de 
choisir si l’application s’exécutera dans le simulateur iPhone ou dans le simulateur 
iPad. Vous pouvez également utiliser la commande Appareil dans le menu Matériel 
pour parvenir au même résultat. Si vous le désirez, vous pouvez également choisir la 
version d’iOS utilisée avec la commande Version dans le menu Matériel. 

- Certaines gestuelles et actions de l’utilisateur peuvent être reproduites dans le simu- 
lateur iOS, à l’aide de commandes dans le menu Matériel ou de raccourcis clavier. 

- Line application peut afficher des informations textuelles dans le volet de débogage 
en utilisant l’instruction NSLogO. 
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Deuxième partie 

Le langage Objective-C 
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Les bases de l'Objective-C 


Difficulté : __ 

C omme je vous le disais dans la première partie de ce livre, nous allons utiliser le langage 
Objective-C pour développer nos applications. Et pour bien comprendre comment 
fonctionne l’Objective-C, vous devez dans un premier temps en acquérir les bases. Tout 
ce qui sera dit ici vous sera profitable lorsque vous écrirez des applications en Objective-C. 

Nous allons y aller en douceur et vous verrez que, progressivement, vous serez capables de 
réaliser de plus en plus de choses avec ce langage. Alors allons-y ! 
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Avant tout chose, je vous rappelle que le langage Objective-C hérite du langage C, 
c’est-à-dire que leur syntaxe de base est relativement similaire. Si vous connaissez déjà 
le C, vous pouvez directement vous rendre au chapitre suivant. Si vous voulez en savoir 
plus sur le langage C, le Site du Zéro propose un tutoriel. 


> 


Lire le tutoriel « Apprenez à 
programmer en C » 
v Code web : 309047 y 


Tout ce qui va être dit dans ce chapitre est relativement théorique. Malheureusement, 
c’est un passage obligé pour apprendre le langage Objective-C. Cependant, rien ne vous 
empêche de tester ce que vous apprenez au fur et à mesure. 


Pour commencer, définissez un nouveau projet appelé « test » basé sur le modèle Single 
View Application. Cliquez sur ViewController .m dans le volet de navigation (1) et 
entrez les instructions à tester dans la méthode viewDidLoad, juste après le message 
[super viewDidLoad] ; (2), comme indiqué à la figure 4.1. 



Figure 4.1 - Insérez une instruction dans votre code 

Pour tester votre code, une des façons les plus simples consiste à afficher des éléments 
textuels dans le volet de débogage (aussi appelé « console ») avec la fonction NSLogO- 
À titre d’exemple, tapez cette ligne de code à la suite de [super viewDidLoad] : 

l| NSLog ( @ " texte à afficher"); 

Cliquez sur l’icône Run (1) pour exécuter l’application et, si nécessaire, cliquez sur 
Hide or show the Debug area (2) pour afficher le volet de débogage. Comme vous 
pouvez le constater à la figure 4.2, le texte passé à la fonction NSLogO est affiché dans 
le volet de débogage. 
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s e o 
► ■ ) (TT 



iPho 

Stlwm 


Q test.xcodeproj m ViewControllerm 
Running i«»t on iPhone 5.0 Simulator 


1 


A S » P 


j teit 

h AppOelegate.h 
m AppOelegate.m 
[ • MainStorytooard.storvboard 
h ViewComroller.h 


test test m VievuController.m Q -viewOidLoad 

- (void)didReceivcMcinoryWarning 

< 

(super didReceiveflefloryWarning] ; 

// Release any cached data, mages, etc that aren't in use. 

I ) 

«pragaa mark - View lifecycle 
(void)viewDidload 



< 


► Suppotting Files 

► i Frameworks 

► j Products 


(super viewOidLoadl ; 

NSLog <$"tcxte a afficher*'): 


(void)vlewDidUnload 

(self setTest:nilJ; 

(super viewOidUnload] ; 

// Release any retained tubviewt of the aain viei 
// e.g. self .«yOut let • nil; 


+ © 0 Gf 9 


| > 

• (void)viesdfillAppear: (BOOL)aninated / 

( / 

[super viewWillAppear:animated] ; " 

a ii ? i i -f • «« / 

Ail Output î M 

type "snow copying- ro see me conoiTtons. ^ 

There is absolutely no warranty for GOB. Type "show waÆanty" for details. 
This GD8 was configured as "x86_64-apple-darwin" . IL 
i Attaching to process 4146. 

2911-11-17 17:19:55.954 test [ 4146 : f 893 ) texte à afficher 


Clear E D ’B 


Figure 4.2 - Le texte est bien affiché 


Est-ce que NSLogO peut afficher autre chose que du texte? 


Oui, bien sûr. N’ayez crainte, vous découvrirez cela en temps utile. Passez vite à la 
suite pour faire connaissance avec vos premières instructions Objective-C. 



Instructions 

Avant de pouvoir conduire une voiture, vous devez apprendre un certain nombre de 
règles. Pour cela, vous devez potasser le code de la route. Une fois cette première étape 
acquise, vous pouvez vous lancer dans la conduite. Là encore, vous devez apprendre 
plusieurs choses. Certaines ne sont pas essentielles. Par exemple, il n’est pas indispen- 
sable de savoir comment fonctionne le moteur de la voiture. D’autres sont par contre 
vitales : il est impensable de se mettre au volant d’une voiture si on ne sait pas mettre 
en route le moteur ou passer les vitesses ! 

Les choses sont assez similaires en programmation. Vous allez devoir apprendre des 
règles, acquérir des mécanismes et beaucoup pratiquer avant d’arriver à faire ce que 
vous voulez. Cela vous prendra du temps et de l’énergie, mais imaginez quelle joie vous 
éprouverez lorsqu’une de vos applications sera téléchargée, utilisée et appréciée par des 
milliers d’inconnus ! Pour l’instant, nous n’en sommes pas là. Commençons déjà par les 
bases de la programmation. 

Tous les programmes sont constitués d’instructions. Une instruction demande à l’ordi- 
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nateur d’effectuer quelque chose de précis. Généralement, on écrit une seule instruction 
par ligne. 

Voici une instruction Objective-C plutôt simple : 

1 | int leNombreDix = 10; 

Et voici une instruction Objective-C un peu plus compliquée : 

l| NSDateFormatter * mi seEnForme = [ [NSDateFormatter alloc] init]; 

Je suis sûr que vous trouvez la première plus sympathique que la deuxième. Mais 
rassurez-vous, ces deux instructions sont très simples à comprendre du moment que 
l’on connaît le « code de la route » Objective-C. 

Pour l’instant, contentez-vous de retenir qu’un programme est constitué d’un en- 
semble d’instructions. Au fil des chapitres, votre compréhension du langage Objective- 
C sera de plus en plus claire et vous pourrez commencer à concevoir vos propres appli- 
cations. 

Je vois que toutes les lignes se terminent par un « ; ». Est-ce que ce caractère 
est obligatoire? 

Eh bien oui, le « ; » est obligatoire. Il indique à l’ordinateur que l’instruction est ter- 
minée. Il faudra donc vous y faire : toutes les instructions se terminent par un « ; ». 



Variables, constantes et opérateurs 

Les variables 

Le langage Objective-C n’aurait aucun intérêt s’il n’était pas capable de manipuler des 
données. Ceci est possible grâce aux variables. En effet, ces dernières permettent de 
stocker temporairement des informations dans la mémoire de votre device et d’y accéder 
par la suite. Grâce à elles, vous allez pouvoir stocker l’âge ou la taille du visiteur, mais 
aussi effectuer des calculs et bien d’autres choses encore. 

Le terme « variable » a été choisi car la donnée mémorisée est susceptible 
de changer de valeur pendant l'exécution du programme. Elle est donc. . . 
variable. 

Pour définir une variable, vous utiliserez la syntaxe suivante : 

1 | type nomVariable; 

Où : 

- type est le type de la variable. Cet élément indique ce que la variable est censée 
représenter : un entier, un nombre à virgule, un caractère, etc. 
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- nomVariable est le nom de la variable. 

Souvenez-vous qu'une instruction doit se terminer par un « ; ». 


Par exemple, pour définir une variable nommée « maVariable » dont le type est int, 
vous utiliserez l’instruction suivante : 

1 | int maVariable ; 

Pas si vite! Qu'est-ce que veut dire int et pourquoi le deuxième mot est 
orthographié ainsi : maVariable et pas Ma variable? 

int vient du mot anglais integer (« entier » en français). Il faudra vous y faire : la 
plupart des langages de programmation sont en anglais. Pour ceux qui auraient des 
lacunes en maths, un entier est un nombre sans virgule, comme par exemple 12 ou 
65241. 

Quant à la syntaxe du deuxième mot, elle adopte la convention camelCase, qui consiste 
à utiliser une première lettre minuscule et une lettre majuscule pour chaque nouveau 
mot. Cette façon de faire n’est pas obligatoire, c’est juste une convention : vos pro- 
grammes fonctionneront quand même si vous ne l’utilisez pas. 

De plus, l’Objective-C interdit les espaces et les accents dans les noms de variables. 
Par exemple, maPremiereVariable respecte la convention camelCase et ne contient 
ni espace ni accent ; le nom est donc correct. A contrario , Ma première variable ne 
respecte pas la convention camelCase et contient des espaces et un accent ; le nom est 
donc incorrect. 

Notez également qu'Objective-C est sensible à la casse des caractères, c'est- 
à-dire aux minuscules et aux majuscules. Ainsi par exemple, les variables 
unEntier, UnEntier et UNentier sont différentes. Si vous tentez d'utili- 
ser plusieurs de ces noms pour désigner une même variable, des erreurs se 
produiront et l'application ne pourra pas s'exécuter. 

Si vous le souhaitez, il est possible d’affecter une valeur à une variable pendant sa 
déclaration. Vous utiliserez alors la syntaxe suivante : 

1 | type nomVariable = valeur; 

Où type est le type de la variable, nomVariable est son nom et valeur est la valeur 
que vous voulez lui affecter. Par exemple : 

1 | int maVariable = 10; 

Ici, la valeur 10 est affectée à la variable maVariable de type int. 

Vous pouvez manipuler ces variables comme bon vous semble. Par exemple : 





45 


CHAPITRE 4. LES BASES DE L’OBJECTIVE-C 


1 int résultat , nombrel = 10, nombre2 = 5; 

2 résultat = nombrel + nombre2 ; 


Ici la variable résultat vaudra 15 : 10 + 5 = 15. Bon, je vous l’accorde, pour le 
moment ça ne nous sert pas à grand-chose. Mais croyez-moi, c’est primordial. 



Notez que pour la première instruction, je n'ai renseigné qu'une seule fois le 
type des variables, avant de les séparer par des virgules. C'est plus rapide à 
écrire (oui les développeurs sont des fainéants). 


Que diriez- vous maintenant d’un peu de pratique? Ouvrez votre projet de test, celui 
défini quelques pages avant. 

Comme vous le montre la figure 4.3, cliquez sur ViewController .m (1) dans le volet 
de navigation, repérez la méthode viewDidLoad et ajoutez les deux lignes de code 
précédentes à la suite de [super viewDidLoad] . 

Ajoutez un NSLog pour afficher la valeur de la variable résultat dans le volet de 
débogage : 

l| NSLog (©"Résultat vaut */,d" , résultat ) ; 

Cliquez sur Run (2) pour exécuter l’application. Si le volet de débogage n’est pas affiché, 
cliquez sur Hide or show the Debug area (3). Au bout de quelques instants, le volet 
de débogage affiche fièrement le résultat. 



-J 1 target. .OS SDK S 0 

▼ _j test 

h AppOclegatr.h 
m AppOelegatc m 
[ MamStoryboard.storyboard 
lh ViewController. h 


[super didReceiveMemoryWarning] ; 

II Release any cached data, mages, 


etc that aren’t in use. 


► Supporting Files 

► i Framework! 

► i Products 




p régna mark - View lifecycle 
(void) viewDidLoad 
(super viewOidLoad] ; 

int résultat, nombrel - 19, nombre2 • S; 
résultat » nombrel • nombre2; 

NSLog («^Résultat vaut M", résultat); « 


(vold)viewDidUnload 

(m I MtTcst i nill t 
[super viewOidUnload) ; 

Il Release any retained subviews of the main ' 
Il e. g. self .myOutlet • ntl; 


\ 

I 

/ 

/ 


+ ® B Qf ^ 


| - (voia) viewWilUppear: (BOOL)aninated 

f 


H H 'S ± 1 -f **»* 

/ 


Ail Output î 

/ 

Clear CDU 

There is absolutely no warranty for GDB. Type "show 
This GDB was configured as “n86_64-apple-darwin". 
Attaching to process 431B. 

2111-11-17 17:31:57.767 test 1 4318 : f 863 1 Résultat vaut 

warranty" /or details. 



Figure 4.3 - Le résultat est affiché dans le volet de débogage 
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Avez-vous remarqué l'étrange « °/ 0 d » dans la fonction NSLogO ? Ce para- 
mètre indique à Xcode le type de la valeur à afficher. Ici, °/„d signifie « variable 
entière » . 


Le langage Objective-C peut utiliser plusieurs autres types de variables. Les plus fré- 
quents ont été rassemblés dans le tableau ci-dessous. Ne vous attardez pas trop sili- 
ce tableau. Vous y reviendrez dans les sections suivantes, lorsque vous testerez des 
variables d’un de ces types. 


Type 

Signification 

y.c 

Objet Cocoa. NSString par exemple 

*/.d, y.i 

Entier signé (c’est-à-dire avec un signe « - » si nécessaire) 

y.f 

Float ou Double 

le 

Caractère 


Les constantes 

Les constantes sont comparables aux variables, à ceci près qu’une fois définies leur 
valeur ne peut pas changer. Voici la syntaxe à utiliser : 

1 | const type nomConstante = valeur; 

La syntaxe est identique à celle des variables, à ceci près que l’on ajoute le mot-clé 
const au début de l’instruction. 

Par exemple : 

l| const float pi = 3.1415926536; 

En résumé, vous utiliserez des variables pour mémoriser des valeurs qui peuvent chan- 
ger dans le temps et des constantes pour stocker des valeurs fixes tout au long du 
programme (une TVA de 19,6 % par exemple). 


Les opérateurs 

Comme leur nom le laisse supposer, les opérateurs permettent d’effectuer des opéra- 
tions. Dans cette section, nous allons nous intéresser aux opérateurs d’affectation et 
aux opérateurs arithmétiques. 


Opérateurs d’affectation 

Les opérateurs utilisables en Objective-C sont regroupés dans le tableau qui suit. 



Il existe d'autres opérateurs d'affectation, mais nous les passerons sous silence 
pour l'instant car ils risqueraient de vous embrouiller. Arrivés à ce point du 
livre, ce qui compte c'est que vous compreniez la logique d'utilisation des 
opérateurs d'affectation. 
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Opérateur 

Signification 

Exemple 

= 

Affectation 

int maVariable = 2; 

+= 

Ajout de la valeur spécifiée 

maVariable += 5 ; 

Ajoute 5 à maVariable. 

- = 

Soustraction de la valeur spé- 
cifiée 

maVariable -= 5; 

Soustrait 5 à maVariable. 

/= 

Divise par la valeur spécifiée 

maVariable /= 5; 

Divise par 5 maVariable. 

* = 

Multiplie par la valeur spéci- 
fiée 

maVariable *= 5; 

Multiplie par 5 maVariable. 


Donne le reste de la division 
entière dont le diviseur est 
spécifié 

maVariable “/,= 5 ; 

Stocke dans maVariable le 
reste de la division entière de 
maVariable par 5. 


Je ne comprends rien à ce tableau ! Quelques explications seraient les bien- 
venues. 

L’instruction suivante (issue de la deuxième ligne du tableau) vous paraît certainement 
un peu farfelue, voire même totalement incompréhensible : 

I | maVariable += 5; 

II s’agit d’une facilité, ou plutôt d’un raccourci d’écriture. Cette instruction est équi- 
valente à : 

1 | maVariable = maVariable + 5; 

Est-ce que c’est plus clair pour vous maintenant ? Ou avez- vous encore un peu de mal 
à comprendre comment on peut stocker dans maVariable la valeur maVariable + 5 ? 
Si vous accrochez là-dessus, sachez que le résultat de maVariable + 5 est calculé dans 
un premier temps, puis ensuite stocké dans maVariable. 

Les autres opérateurs d’affectation fonctionnent de même. Ainsi par exemple : 

1 | maVariable '/,= 5; 

Est équivalent à : 

1 | maVariable = maVariable '/, 5; 

Après l’exécution de cette instruction, maVariable contient le reste de la division en- 
tière (’/,) de maVariable par 5 (maVariable °L 5). 

C'est quoi exactement ce "/„ dont tu nous parles? 
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C’est ce qu’on appelle un modulo. Il permet d’obtenir le reste d’une division. Par 
exemple, si je divise 5 par 2 (5/2), il reste 1. Ainsi, 5%2 = 1 


Opérateurs arithmétiques 

Vous connaissez forcément les quatre opérateurs arithmétiques de base : plus, moins, 
divisé par et multiplié par. Vous aurez également à faire à quelques autres opérateurs, 
moins fréquents mais très utiles en programmation. Je les ai regroupés dans le tableau 
suivant. 


Opérateur 

Fonction 

+ 

Addition 

- 

Soustraction ou inversion de signe 

++ 

Incrémentation (ajout de 1) 

-- 

Décrémentation (soustraction de 1) 

* 

Multiplication 

/ 

Division 

1 

Modulo (reste de la division entière) 


Ne soyez pas effrayés si c’est la première fois que vous rencontrez certains de ces opé- 
rateurs. 

- ++ ajoute 1 à une variable entière. À titre d’exemple, variable++ ou ++variable 
est équivalent à variable = variable + 1. 

- -- soustrait 1 d’une variable entière. À titre d’exemple, variable-- ou --variable 
est équivalent à variable = variable - 1. 

- "/o renvoie le reste d’une division entière. Par exemple 15%2 renvoie 1. En effet, si 
vous divisez 15 par 2, le reste de la division est 1. 

Et maintenant, voici quelques exemples d’utilisation : 

1 int varl = 10 ; 

2 int var2 = 1 5 ; 

3 int resuit ; 

4 resuit = varl * var2 ; 

5 result++; 

6 resuit = 15 / 10 

- Les lignes 1 et 2 définissent les variables int varl et var2 valant (respectivement) 
10 et 15. 

- La ligne 3 définit la variable int resuit, mais ne lui affecte aucune valeur. 

- La ligne 4 affecte à resuit le résultat de la multiplication de varl par var2. Après 
l’exécution de cette instruction, resuit vaut donc 150 (10 * 15). 

- La ligne 5 ajoute 1 à la variable resuit. Cette dernière vaut donc 151 après l’exé- 
cution de l’instruction. 

- Enfin, la ligne 6 affecte à resuit le reste de la division entière de 15 par 10. Après 
l’exécution de cette instruction, resuit vaut 5. En effet 15/10 = 1, reste 5. 
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Lorsque plusieurs opérateurs apparaissent dans une expression mathématique, il est 
nécessaire de savoir dans quel ordre ils sont utilisés. Pour les opérateurs +, -, * et 
/, les règles sont les mêmes que dans l’algèbre traditionnelle. À savoir que * et / sont 
prioritaires par rapport à + et -. En cas de priorités identiques, les calculs sont effectués 
de gauche à droite. 

D’après vous, quelle est la valeur stockée dans la variable resuit ? 

1 | float resuit = 10 * 2 + 120 / 2; 

Le résultat de cette opération est 80. L’évaluation se fait en calculant 10*2 puis 120/2. 
Ces deux valeurs sont ensuite ajoutées. Ainsi 20 + 60 = 80. 

Si nécessaire, vous pouvez utiliser un ou plusieurs jeux de parenthèses pour modifier 
l’ordre d’évaluation, et donc le résultat. D’après vous, quelle est la valeur stockée dans 
la variable resuit ? 

1 I float resuit = 10 * (2 + 120) / 2; 


Le résultat est 610. L’opération 2+120 étant entourée de parenthèses, elle est prioritaire 
et donc calculée en premier. Les opérateurs * et / ayant le même niveau de priorité, 
l’expression est évaluée de la gauche vers la droite. Ainsi, resuit a pour valeur 10 
multiplié par 122 puis divisé par 2, soit 610. 

L’opérateur unaire - (en d’autres termes, le « - » qui inverse le signe d’un nombre 
ou d’une variable) est prioritaire. Il en va de même des opérateurs ++ et -- lorsqu’ils 
sont utilisés en préfixe (++variable et --variable). Ils sont donc exécutés en premier. 
Viennent ensuite au même niveau les opérateurs *, / et %, et enfin les opérateurs + et -. 

Et maintenant, un peu de pratique! 

Dans votre projet de test, cliquez sur ViewController .m dans le volet de navigation, 
repérez la méthode viewDidLoad et ajoutez les lignes de code précédentes à la suite 
de [super viewDidLoad]. Invoquez la fonction NSLogO chaque fois que vous voulez 
tester une variable. Voici à quoi pourrait ressembler la méthode viewDidLoad : 


1 

2 

3 

4 

5 

6 

7 

8 
9 

10 

11 

12 

13 

14 

15 

16 
17 


- (void) viewDidLoad 

{ 

[super viewDidLoad]; 
int varl = 10 ; 
int var2 = 15 ; 
int resuit ; 

resuit = varl * var2 ; 

NSLog ( @ " var 1 * var2 = ’/.d" , resuit ) ; 

resuit ++ ; 

NSLog ( @ " Apre s le ++ , resuit vaut */,d" , resuit ) ; 
resuit = 15 / 10 ; 

NSLog (<§"15 10 vaut '/,d" , resuit ) ; 

float resultl = 10 * 2 + 120 / 2; 
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18 

MSLog 

(<§' 

10 * 

2 + 

120 / 2 

vaut 

7.f " 

resuit 1 ) ; 

19 









20 

f loat 

r< 

îsult2 

= 

10 * (2 + 

120) 

/ 2 


21 

NSLog 

(0' 

10 * 

(2 

+ 120) / 

2 vaut 

y.f 

, result2 ) 

22 

} 









> 


Cliquez sur Run pour exécuter l’application. Si le volet de débogage n’est pas affiché, 
cliquez sur Hide or show the Debug area. Au bout de quelques instants, le volet de 
débogage affiche les divers résultats. Comme vous pouvez le voir à la figure 4.4, ils sont 
conformes aux attentes. 


Copier ce code 
Code web : 494253 


# O O ^3 testxcodepro) - mf ViewController.m 


0 (■) [l.. Ifho -, Runnlno test on iPhone 5.0 Simulator [□] t J ^ I 1 SJ 

Run Stop Scheme Breakpomts ° * **** * Editor view Organizer 


ViewController.m 


f ' - ~ 

+ 

i n 8 ô = » P 

:s 

< P (est test m ViewControlier.m £3 -viewDidLoad 


T «V test 




1 urpet. iOS SDK S.O 


- (void)vicwOidLoad 


▼ test 

h AppDelegate.h 


{ 

I s upe r v îewü îdLoad ] ; 
int varl = 10; 


m AppDelcgjte m 


int var2 = 15; 


(&J MamStoryboard storyboard 


Int resuit; 


h VtewController h 






NSLog(9“varl • var2 « %d", resuit); 


► Supporting Files 



► Q Framework* 


result++; ^ 


► , Products 






resuit • 15 % 10; 

NSLog(e“15 %% 10 vaut W, resuit); 




X 




f loat resultl = 10 • 2 ♦ 128 / 2; \ 

NSLog<#“10 .2 + 120/2 vaut %f“, resultl); 

f loat result2 * 10 a (2 + 120) / 2; \ 

NSLog(«“18 . 42 * 129) / 2 vaut |kf" , result2) ; | 

} | 



H 

H Q 1 i I f i«« | 





Ail Output : Clear /£_ 

d n 


GNU gdb 6.3.50-20850815 «Apple version gdb-1708) (Non Aug 8 28:32:45 UTC 2811) / 

Copyright 2884 Free Software Foundation, Inc. t 



GDB 

is free software, covercd by the GNU General Public Licensc, and you are . 



welcone to change it and/or distnbute copies of ît under certain conditions. i 

Type “show copying" to see the conditions. f 

There is absolutely no warranty for GDB. Type “show warranty" for details. » 

This GDB was configured as *‘x86_64-apple-darwin“. » 

Attaching to process 4838. f 

2811-11-17 18:48:18.899 test [4B38: f 883] varl a var2 = 158 

2811-11-17 18:48:18.143 test [ 4838 : f 883 ) Après le resuit vaut 151 W 



2811-11-17 18:48:18.143 test [4838 : f 883] 15 % 18 vaut 5 

2811-11-17 18:48:18.144 test(4830:fS83] 18 « 2 « 128 / 2 vaut 88.898990 

2811-11-17 18:48:18.145 test [4839 : f 803] 18 a (2 ♦ 120) / 2 vaut 618.860808 


+ ® @ Q’ 9 





Figure 4.4 - Les résultats sont bien affichés et sont corrects 

Avant d’en terminer avec ceci, je voudrais faire une remarque sur une des fonctions 
NSLogO utilisées dans ce code. 

Avez-vous remarqué un détail surprenant dans l’instruction suivante, vers le milieu de 
la méthode viewDidLoad ? 

l| NSLog(@"15 '/,*/, 10 vaut */,d" , resuit ) ; 

Le signe « 7, » a une signification particulière. En effet, associé à une lettre (°/„d ou 
7„f par exemple), il précise le type d’une variable que l’on désire afficher. Dans cette 
instruction, on désire afficher le signe « °/ » dans le volet de débogage. C’est la raison 
pour laquelle il est doublé. 
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Commentaires 

Un commentaire est un texte dans un programme, non pris en compte lors de l’exé- 
cution de ce dernier. Ils sont très utiles en programmation puisqu’ils vous permettent 
de vous y retrouver dans votre code. Imaginez que vous créiez une application et que, 
quelques mois ou même quelques années plus tard, vous décidiez de la mettre à jour. 
Même si vous êtes l’auteur du code, il vous sera difficile de tout comprendre au premier 
coup d’œil. C’est pourquoi il est fortement recommandé d’insérer des commentaires qui 
expliquent de manière claire ce que vous avez fait. 

Pour insérer un commentaire qui tient sur une seule ligne, vous le ferez précéder d’un 
double slash : 

1 | int maVariable = 10; // maVariable vaut 10 

Ce qui se trouve avant le double slash n’est pas un commentaire. Vous notez 
d'ailleurs que le « ; » se trouve avant le commentaire ; ce dernier ne fait donc 
pas partie de l'instruction. 

Si le commentaire s’étale sur plusieurs lignes, vous utiliserez les caractères « /* » pour 
marquer le début et « */ » pour marquer la fin du commentaire : 

1 /* 

2 Ceci est un commentaire 

3 sur 

4 plusieurs lignes 

5 */ 



Types de données 


Les variables utilisées jusqu’ici étaient de type entier (int) et à virgule (float). Ces 
deux types ne sont pas les seuls. Vous allez maintenant découvrir les différents types 
de base utilisables en Objective-C. Vous apprendrez également à effectuer des conver- 
sions entre ces différents types de données. 



Les types plus complexes seront abordés progressivement dans les chapitres 
suivants. 


Booléens 

Le type B00L est utilisé lorsque vous devez manipuler des informations de type vrai/faux, 
oui/non ou 0/1. Ces informations sont dites « booléennes ». 

Voici quelques exemples de déclaration : 
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1 BOOL booleenl = 0; 

2 BOOL booleen2 = NO; 

3 BOOL booleen3 = 1 ; 

4 BOOL booleen4 = YES ; 



NO et 0 sont équivalents ; YES et 1 le sont également. 


Entiers 

Il n’existe pas un mais plusieurs types de variables entières. Vous choisirez un type 
plutôt qu’un autre en fonction des valeurs maximales que peuvent prendre les variables 
ou constantes concernées. 


Variable 

Valeurs possibles 

short int 

-32768 à 32768 

unsigned short int 

0 à 65535 

unsigned int et unsigned long int 

0 à 4294967295 

int et long int 

-2147483647 à 2147483647 

long long int 

-9223372036854775807 à 9223372036854775808 

unsigned long long int 

0 à 18446744073709551615 


Par exemple : 

1 int variableEntiere = 123456; 

2 short int entierCourt = -54; 


Réels 

Les réels, aussi appelés « nombres à virgule flottante », sont des nombres à virgule, 
comme par exemple 176.45 ou encore -0.561. Selon leur précision (c’est-à-dire selon 
le nombre de chiffres après la virgule), ils sont mémorisés dans des variables de type 

f loat ou double. 

Comme pour la plupart des langages de programmation, les nombres à virgule 
s'écrivent avec un point (« . ») et non une virgule (« , ») : 4.5 et non 4,5. 

Les variables/constantes de type float peuvent être comprises entre 3.4 x 10 -38 et 
3.4 x 10 38 . Quant aux variables/constantes de type double, elles peuvent être comprises 
entre 1.7 x 10" 308 et 1.7 x 10 308 . 
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Que signifie 3.4 x 10 38 ? 

Il s’agit d’une convention d’écriture dite « scientifique ». 10~ 38 signifie 38 zéros avant 
la valeur numérique. Et 3.4x signifie que le nombre 3.4 est multiplié par le nombre 
10~ 38 . Si vous avez du mal à visualiser tout ça, la figure 4.5 devrait vous aider. 




Figure 4.5 - 3.4 x 10 38 est en fait un nombre à virgule avec 38 zéros 


Caractères 

Le type char permet de manipuler des chaînes composées d’un et d’un seul caractère. 
Le caractère manipulé doit être délimité par des apostrophes : 

1 char monCaractere = 'a' ; 


Les pointeurs 

Les pointeurs sont généralement redoutés comme la peste par les programmeurs débu- 
tants. Pourtant, ils rendent de grands services et vous devez absolument comprendre 
leur fonctionnement pour bien programmer en Objective-C. Pour l’instant, retenez leur 
principal intérêt : ils facilitent la manipulation des objets en Objective-C. Jusqu’ici, 
tout va bien. Nous allons donc aller un peu plus loin. 

Sachez que les pointeurs ne sont pas un type de données. Il est donc impossible 
d’écrire quelque chose comme ceci : 

1 | pointer maVariable ; 

Contrairement aux types de données, les pointeurs ne sont pas utilisés pour stocker 
des données, mais des adresses. Par exemple, lorsque vous faites int monEntier = 
10 ; , un espace en mémoire (dont la taille dépend du type de la variable) est réservé 
pour stocker la valeur 10. Cet espace se trouve à l’adresse fanonEntier. Utilisons une 
instruction NSLog pour afficher la valeur et l’adresse de la variable monEntier : 

î 
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NSLog ( @ " monEnt ier vaut */,i et son adresse en mémoire est '/,p", 
monEntier, tmonEntier) ; 


LES POINTEURS 


Voici le résultat affiché dans la console : 


[...] monEntier vaut 10 et son adresse en mémoire est 0xbfffd6f4 



Remarquez l'utilisation de la chaîne °/„p pour afficher le pointeur. Chaque fois 
que vous voudrez afficher l'adresse contenue dans un pointeur, vous utiliserez 
une chaîne °/ 0 p. 


Ce qui vient d’être dit n’est peut-être pas très clair pour vous. Si tel est le cas, nous 
allons prendre quelques instants pour approfondir les choses. Sans vouloir jeter un 
froid, voici une définition sur laquelle vous devriez méditer : « un pointeur est une 
variable qui contient l’adresse d’une autre variable d’un type donné ». 

Examinez la figure 4.6. 


Adresses en mémoire 



Figure 4.6 - L’emplacement d’adresse 17 contient un pointeur vers l’emplacement 
d’adresse 207 

Le rectangle horizontal représente une partie de la mémoire de votre ordinateur. Chaque 
case correspond à un emplacement en mémoire. Pour repérer facilement les différents 
emplacements, on leur affecte un nombre appelé « adresse ». Dans cette figure, l’empla- 
cement d’adresse 17 contient un pointeur vers l’emplacement d’adresse 207. En utilisant 
le « pointeur » d’adresse 17, on pourra donc accéder à la donnée stockée à l’adresse 
207. En résumé : 

- les pointeurs sont utilisés pour mémoriser des adresses, pas des données ; 

- les données contenues dans les emplacements en mémoire ainsi « pointés » peuvent 
changer ; 

- les variables, quant à elles, ont un type défini une fois pour toutes et sont donc 
« figées » . 

Les deux derniers points représentent la différence essentielle entre les pointeurs et 
les variables. Si vous réfléchissez à cela, vous découvrirez un autre intérêt majeur des 
pointeurs : ils font référence à des données dont le contenu et la taille peuvent changer. 
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Si vous ne comprenez pas encore très bien le pourquoi du comment, ne vous 
attardez pas trop sur ce qui vient d'être dit. C'est en utilisant les pointeurs 
que vous comprendrez leur intérêt et, très vite, vous ne pourrez plus vous en 
passer ! 


Voyons comment définir un pointeur en Objective-C : 
l| int *pointeurSurMonEnt ier ; 

Supposons que pointeurSurMonEntier représente l’adresse de la variable monEntier. 
Afin de relier ces deux éléments, nous allons utiliser le signe & : 

1 int monEntier = 10; 

2 int * po int eur SurMonEnt ier = imonEntier ; 


Tout comme les variables, les pointeurs ont un type. Ici par exemple, 
=rpointeurSurMonEntier est de type int, c'est-à-dire du même type que la 
variable à laquelle il fait référence. Cette remarque se généralise : un pointeur 
est toujours du même type que la variable sur laquelle il pointe. 

Il est possible de modifier la valeur d’une variable en agissant sur son pointeur. Par 
exemple, pour affecter la valeur 25 à la variable monEntier, on peut utiliser indifférem- 
ment les deux instructions suivantes : 

1 monEntier = 25; 

2 * po int eur surMonEnt ier = 25; 



Chaînes de caractères 

Les chaînes de caractères sont composées de zéro, un ou plusieurs caractères. Comme il 
a été vu un peu plus tôt, les variables et constantes de type char ne peuvent mémoriser 
qu’un et un seul caractère. Pour mémoriser des chaînes, nous utiliserons des pointeurs 
de char. 

Qu'est-ce encore que cela? 


Les pointeurs de char sont des zones mémoire qui mémorisent l’emplacement d’une 
suite de zéro, un ou plusieurs char. C’est précisément ce que sont les chaînes de carac- 
tères. Les pointeurs de char sont donc particulièrement bien adaptés à leur définition. 

À titre d’exemple, l’instruction suivante définit la chaîne nom et l’initialise avec une 
chaîne de caractères : 

1 char ♦nom = "Mon nom est Bond, James Bond"; 



56 


LES POINTEURS 


Structures 

Jusqu’ici, nous avons étudié des types de données « simples » : booléens, entiers, flot- 
tants, doubles, caractères et chaînes de caractères. Il est parfois nécessaire de regrou- 
per plusieurs informations disparates dans une seule et même variable. Imaginez par 
exemple que vous désiriez mémoriser le prénom, le nom et l’âge de plusieurs personnes. 
Le plus simple consiste à regrouper ces informations dans une structure en utilisant 
l’instruction struct : 

1 struct unePersonne 

2 { 

3 char ♦prénom; 

4 char *nom; 

5 int âge ; 

6 }; 

Une fois cette structure définie, on peut définir une variable de type unePersonne et 
accéder à ses différentes composantes en utilisant des instructions « à point ». Par 
exemple : 

1 struct unePersonne schwarzi; 

2 schwarzi . prénom = "Arnold"; 

3 schwarzi. nom = "Schwarzenegger"; 

4 schwarzi. âge = 64; 


Conversions de type 

Dans votre vie de programmeur Objec.tive-C, vous serez souvent amenés à convertir 
une variable d’un certain type en une variable d’un autre type. En effet, les types des 
variables manipulées doivent être exactement ceux attendus dans le langage, sans quoi 
une erreur se produira et il sera impossible d’exécuter le programme. 

La conversion peut être « implicite » (c’est-à-dire sans nécessiter l’intervention du pro- 
grammeur) ou « explicite » (c’est-à-dire en utilisant un opérateur de conversion). 


Conversion implicite 

Examinons les quelques lignes de code suivantes : 

1 int a = 10 ; 

2 float b = 13.562; 

3 int c = a * b ; 

4 float d = a * b ; 

Le produit de a par b est égal à 135.62. Cette valeur est de type flottant puisqu’elle 
comporte des décimales. 

Quelles valeurs auront les variables c et d selon vous ? 
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À la ligne 3, lorsque la valeur 135.62 est stockée dans la variable entière c, elle est 
« tronquée » (c’est-à-dire privée de ses décimales) à 135. L’instruction int c = a * 
b; a effectué une conversion implicite du type f loat vers le type int afin que le résultat 
puisse être mémorisé dans la variable entière c. 

Par contre, dans la ligne 4, lorsque la valeur 135.62 est stockée dans la variable flottante 
d, elle est égale à 135 . 62. 


Conversion explicite 

Pour effectuer une conversion explicite (on dit aussi un casting), il suffit de préciser le 
type visé entre parenthèses avant la valeur à convertir. 

1 int a = 10 ; 

2 float b = 13.562; 

3 float c = a * (long int)b; 

4 NSLog ( © " 7. f " , c) ; 


Est-il possible d'avoir quelques explications sur la ligne 3? 


La variable b est de type float, puisqu’elle est déclarée comme telle à la ligne 2. Le 
casting (long int) b convertit la valeur de la variable b en un long int. Cette valeur 
est ensuite multipliée par la valeur contenue dans la variable a, de type int. Le résultat 
est donc de type long int. Enfin, ce résultat est stocké dans la variable c de type float 
(float c =). Il est donc converti dans le type float. 

Quel résultat sera affiché par l’instruction NSLog selon vous ? Le casting de b en un 
long int donne la valeur entière 13. Le résultat de la multiplication est donc 130. 
Mais étant donné que ce résultat est stocké dans une variable float, NSLog affichera 
130.000000. 

Pour aller un peu plus loin, nous allons nous intéresser à un autre exemple, basé sur 
l’utilisation d’un code ASCII. 

Code ASCII ? Mais qu'est-ce donc que cela ? 


. 'abréviation de American Standard Code for Information Interchange. Il 
s’agit d’une norme d’encodage des caractères alphanumériques de l’alphabet latin. Ainsi 
par exemple, le nombre 64 représente le caractère « @ », le nombre 65 représente le 
caractère « A », le nombre 66 représente le caractère « B », et ainsi de suite. Pour avoir 
de plus amples informations sur le codage ASCII, je vous suggère de vous reporter à 
la table ASCII accessible grâce au code web suivant. 


(Table ASCII 

\ 

v Code web : 277885 

J 


e 

ASCII est 
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Voici notre exemple : 

1 int i = 65 ; 

2 char c = (char) i; 

3 NSLog (<§"*/, c " , c) ; 

En lui appliquant un casting de type (char), la variable char c est initialisée avec le 
caractère A. C’est donc ce qu’affiche l’instruction NSLog. L’entier 65 est donc équivalent 
au caractère A. 


En résumé 

- Une variable permet de stocker temporairement des informations dans la mémoire 
de votre device et d’y accéder par la suite. 

- Pour définir une variable, vous utiliserez l’instruction suivante : type nomVariable ; . 

- Il est possible d’affecter directement une valeur à une variable lors de sa définition : 
type nomVariable = valeur;. 

- Pour définir une constante, utilisez la syntaxe suivante : const type nomConstante 
= valeur;. 

- Un certain nombre de traitements peuvent être appliqués aux variables par l’inter- 

médiaire d’opérateurs. On distingue essentiellement les opérateurs d’affectation (=, 
+=, -=, /=, *= et '/„=) et les opérateurs arithmétiques (+, -, ++, *, / et %). 

- Les commentaires peuvent occuper une seule ligne. Dans ce cas, ils sont précédés 
d’un double slash (//). Ils peuvent également s’étaler sur plusieurs lignes. Dans ce 
cas, ils commencent par les caractères /* et se terminent par les caractères */. 

- Les variables sont caractérisées par leur type : booléen, entier, réel, caractère, chaîne, 
pointeur et structure. 

- Les conversions de types peuvent être implicites (lors de la définition d’une variable) 
ou explicites (en précisant le type recherché entre parenthèses avant la valeur à 
convertir) . 
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Chapitre 



Conditions, boucles et fonctions 


Difficulté : 

D ans ce chapitre, vous allez aller un peu plus loin dans la programmation Objective-C. 
Au fil des pages, vous apprendrez à : 

- effectuer des tests pour exécuter une ou plusieurs instructions si une condition est rem- 
plie ; 

- faciliter la répétition d'instructions; 

- définir et exécuter des fonctions pour exécuter des tâches bien précises. 

Ça n'a l'air de rien comme ça, mais à la fin de ce chapitre vous serez capables de créer de 
petits programmes. 
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Conditions 

En programmation, on utilise des conditions pour tester la valeur des variables. Selon 
le résultat obtenu, zéro, une ou plusieurs instructions peuvent alors être exécutées. 

Avant de nous intéresser aux conditions, nous allons passer un peu de temps avec les 
opérateurs de comparaison. En effet, ces opérateurs sont très souvent utilisés dans des 
conditions. Par exemple pour savoir si une variable est supérieure à une autre, ou encore 
si une variable est égale à zéro. 


Opérateurs de comparaison 

Les opérateurs de comparaison (dits logiques) sont très importants. Ils permettent de 
comparer des valeurs entre elles. Par leur intermédiaire, vous pourrez savoir qui de 
Pierre ou de Jean est le plus grand, ou encore si les prunes sont plus chères au kilo que 
les bananes. J’ai regroupé tous les opérateurs logiques dans le tableau suivant. 


Opérateur 

Signification 

| 

Non 

< 

Inférieur à 

> 

Supérieur à 

== 

Egal à 

<= 

Inférieur ou égal à 

>= 

Supérieur ou égal à 

; = 

Différent de 

&& 

Et logique (vrai si les deux opérandes ont pour valeur true) 

1 1 

Ou logique (vrai si au moins un des deux opérandes a pour valeur true) 


Ou exclusif (vrai si un seul des deux opérandes a pour valeur true) 


Remarquez le double signe égal (==), pour indiquer qu'il s'agit d'un test et 
non d'une affectation. 

Maintenant, nous allons mettre en pratique les opérateurs de comparaison en les utili- 
sant dans des conditions. 

if 

Pour tester une condition, l’opérateur de base est le if ( « si » en français). Par exemple, 
imaginez que la variable pointure contienne une pointure de chaussure. Si la pointure 
est inférieure ou égale à 30, vous voulez afficher un message qui dit « Vous devez vous 
chausser au rayon enfants ». Vous écrirez ceci : 

1 if (pointure <= 30) 

2 { 
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3 NSLog (@ " Vous devez vous chausser au rayon enfants"); 

4 } 

Si la condition est vérifiée (si la variable pointure est inférieure ou égale à 30), alors 
ce qui se trouve entre les accolades sera exécuté. Les plus observateurs d’entre vous 
auront sans doute remarqué que la condition ainsi que les accolades la délimitant ne se 
terminent pas par un « ; ». C’est tout à fait normal, ce ne sont pas des instructions. 

Bien entendu, il est possible d’exécuter plusieurs instructions : 

1 if (pointure <= 30) 

2 { 

3 NSLog (@ "Vous avez de petits pieds"); 

4 NSLog (@ "Vous devez vous chausser au rayon enfants"); 

5 // etc. 

6 } 


Si une seule instruction se trouve entre les accolades, ces dernières sont fa- 
cultatives. 



1 if (pointure <= 30) 

2 NSLog(@"Vous devez vous chausser au rayon enfants"); // Ici 

les accolades sont facultatives 


Que diriez- vous d’un peu de pratique ? 

Ouvrez le projet de test créé au chapitre précédent. Si vous ne l’avez plus, pas de 
panique, vous pouvez en créer un nouveau, il fera aussi bien l’affaire. 

Cliquez sur ViewController .m dans le volet de navigation et complétez la méthode 
viewDidLoad comme suit : 


1 

2 

3 

4 

5 

6 

7 

8 
9 

10 


- ( vo id ) viewDidLoad 

{ 

[super viewDidLoad]; 
int pointure = 29; 
if (pointure <= 30) 

{ 

NSLog (@ "Vous avez de petits pieds"); 

NSLog (<§" Vous devez vous chausser au rayon enfants"); 

} 


À la ligne 4, la variable pointure est initialisée à 29. Mais rien ne vous empêche de 
choisir une autre valeur. 

Exécutez l’application en cliquant sur Run. Si nécessaire, affichez le volet de débogage 
en cliquant sur Hide or show the Debug area. Voici ce qui devrait s’afficher dans le 
volet de débogage : 
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Attaching to process 877. 

[...] test [877 : f 803] Vous avez de petits pieds 

[...] test [877 : f 803] Vous devez vous chausser au rayon enfants 



Ici, le processus 877 est attaché à l'application. Sur votre ordinateur, le pro- 
cessus sera différent. Ceci est tout à fait normal. Notez également que j'ai 
masqué l'heure et la date, ce n'est pas ce qui nous intéresse ici. Ne soyez 
donc pas étonnés si vous rencontrez encore des « [...] ». 


else 

Il arrive parfois que l’on doive exécuter une instruction si une condition est remplie, 
et une autre instruction dans le cas contraire. Pour cela, on a recours au mot-clé else 
(c’est-à-dire « sinon » en français) : 


1 

if (pointure <= 

CO 

O 





2 

NSLog ( @ " Vous 

devez vous 

chausser 

au rayon 

enf ant s 

") 

3 

else 






4 

NSLog ( @ " Vous 

devez vous 

chausser 

au rayon 

adultes 

") 


else if 

Imaginez maintenant que vous vouliez exécuter : 

- une première instruction si la pointure est inférieure ou égale à 30 ; 

- une deuxième instruction si la pointure est supérieure à 45 ; 

- une troisième instruction si la pointure ne répond à aucune de ces deux conditions. 
Pour cela, vous utiliserez les mots-clés if (si), else if (sinon si) et else (sinon) : 

1 if (pointure <= 30) 

2 NSLog ( @ " Vous devez vous chausser au rayon enfants"); 

3 else if (pointure > 45) 

4 NSLog (<§" Vous devez vous chausser sur mesure"); 

5 else 

6 NSLog (<§" Vous devez vous chausser au rayon adultes"); 

Il est bien évidemment possible d’utiliser plusieurs else if. Vous pourriez très bien 
écrire quelque chose comme ceci, même si l’intérêt de ce code est limité : 

1 if (pointure <= 30) 

2 NSLog (<§" Vous devez vous chausser au rayon enfants"); 

3 else if (pointure == 36) 

4 NSLog (<§" Vous chaussez du trente - six ") ; 

5 else if (pointure == 37) 

6 NSLog (<§" Vous chaussez du trente - sept ") ; 

7 else if (pointure == 38) 

8 NSLog (<§" Vous chaussez du trente -huit ") ; 
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N’hésitez pas à tester ce code (n’oubliez pas de déclarer votre variable pointure) en 
changeant ses valeurs. C’est comme ça qu’on apprend ! 


Plusieurs conditions dans un test 

Les opérateurs logiques && (et), I I (ou) et ! (non) peuvent être utilisés dans une condi- 
tion. Par exemple, pour tester si la pointure est supérieure à 35 et inférieure à 42, vous 
écrirez ceci : 

1 | if (pointure > 35 && pointure < 42) 

D’après vous, que devriez- vous écrire pour tester si la pointure est comprise entre 35 
et 42, mais différente de 40. Je vous laisse quelques instants. . . 

Voilà la solution : 

I | if (pointure > 35 && pointure < 42 && pointure != 40) 

Facile, non ? 

II est parfois nécessaire d’utiliser des parenthèses dans un test complexe pour modifier 
l’ordre d’exécution des éléments qui composent le test. Par exemple, les deux tests 
suivants ne sont pas équivalents : 

1 if ( ( a+3 ) /4 < 10) 

2 if (a+3/4 < 10) 

Le premier test ajoute 3 à la variable a, divise cette somme par 4 et compare le résultat 
obtenu à 10. Le deuxième test ajoute 3/4 à la variable a et compare le résultat obtenu 
à 10. 

À titre d’information, voici l’ordre d’exécution des principaux opérateurs, du plus prio- 
ritaire au moins prioritaire : 


Nom 

Opérateur 

Parenthèses 

O 

Opérateur de changement de signe 

- 

Opérateurs ++ et -- utilisés en préfixe 

++ et — 

Négation 

1 

Multiplication, division et modulo 

*, / et 1 

Addition et soustraction 

+ et - 

Inférieur, inférieur ou égal, supérieur, supérieur ou égal 

II 

A 

a" 

if 

V 

V 

Égal, différent de 

== et ! = 

Et logique 

&& 

Ou logique 

1 1 

Affectation 

= 
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L’instruction switch 


Il existe une variante de l’instruction if . . . else if . . . else ... : l’instruction switch. 
Voici sa syntaxe : 


1 

2 

3 

4 

5 

6 

7 

8 
9 

10 

11 

12 

13 

14 

15 

16 


switch (variable) 

{ 

case valeurl : 

une ou plusieurs 
break ; 

case valeur2 : 

une ou plusieurs 
break ; 

case valeur3 : 

une ou plusieurs 
break ; 

def ault : 

une ou plusieurs 
break ; 


} 

Où : 


instructions ; 


instructions ; 


instructions ; 


instructions ; 


- variable est la variable utilisée dans le test ; 

- les case valeurl:, case valeur2:, etc. correspondent aux valeurs à tester; 

- une ou plusieurs instructions; sont des instructions définies sur une ou plu- 
sieurs lignes ; 

- les instructions situées après le mot def ault sont exécutées lorsqu 'aucune des condi- 
tions spécifiées dans les instructions case n’a été vérifiée ; 

- break marque la fin des instructions qui suivent une instruction case ou def ault. 

L’instruction switch est un peu plus complexe que celles que nous avons vues jusqu’ici. 
Un exemple va vous aider à en comprendre le fonctionnement. 

Considérez le test suivant : 


î 

2 

3 

4 

5 

6 

7 

8 
9 

10 


if (pointure == 30) 

NSLog ( @ " Vous devez vous 
else if (pointure ==36) 
NSLog ( @ " Vous chaussez du 
else if (pointure ==37) 
NSLog (<§" Vous chaussez du 
else if (pointure ==38) 
NSLog (<§" Vous chaussez du 
else 

NSLog (<§" Vous ne chaussez 


chausser au rayon enfants") 
trente -six") ; 
trente - sept " ) ; 
trente -huit " ) ; 
pas du 30, 36, 37 ou 38"); 


Vous pourriez tout aussi bien écrire : 

1 switch (pointure) 

2 { 

3 case 30 : 
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4 

5 

6 

7 

8 
9 

10 

11 

12 

13 

14 

15 

16 

17 

18 


NSLog (@ " Vous devez vous chausser au rayon enfants"); 
break ; 
case 36 : 

NSLog (<§" Vous chaussez du trente - six ") ; 
break ; 
case 37 : 

NSLog (<§" Vous chaussez du trente - sept ") ; 
break ; 
case 38 : 

NSLog (<§" Vous chaussez du trente -huit ") ; 
break ; 
def ault : 

NSLog (@" Vous ne chaussez pas du 30, 36, 37 ou 38") ; 
break ; 

} 


Encore une fois, n’hésitez pas à tester ce code en modifiant ses valeurs. 


Boucles 


En programmation, il est souvent nécessaire d’exécuter à plusieurs reprises une instruc- 
tion ou un groupe d’instructions, par exemple tant qu’une condition n’est pas vérifiée. 

Supposons que vous vouliez afficher à dix reprises le mot « Bonjour ». Comment vous 
y prendriez- vous ? La première idée qui vient à l’esprit consiste à répéter dix fois l’ins- 
truction d’affichage NSLog : 


1 

2 

3 

4 

5 

6 

7 

8 
9 

10 


NSLog (@" Bon j our " ) ; 
NSLog (@ " Bon j our " ) ; 
NSLog (@ " Bon j our " ) ; 
NSLog (<§" Bon j our " ) ; 
NSLog (@ " Bon j our " ) ; 
NSLog (@ " Bon j our " ) ; 
NSLog (@ " Bon j our " ) ; 
NSLog (@ " Bon j our " ) ; 
NSLog (@ " Bon j our " ) ; 
NSLog (@ " Bon j our " ) ; 


Imaginez maintenant que vous vouliez répéter 100 fois l’affichage du mot « Bonjour ». 
Allez- vous écrire cent fois la même instruction ? Heureusement non ! Il existe plusieurs 
solutions bien plus élégantes : vous utiliserez pour cela une boucle for, while ou do 
while. 

Dans tous les cas, la procédure est la même. Regardez la figure 5.1, elle représente le 
fonctionnement d’une boucle. 

Voici ce qui se passe : 

- l’ordinateur lit les instructions de haut en bas ; 

- arrivé à la fin de la boucle, il retourne à la première instruction ; 
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e Instructions 
Instructions 
Instructions 
Instructions 

Figure 5.1 - Schéma d’une boucle 

- il lit de nouveau les instructions de haut en bas ; 

- il repart à la première instruction ; 

- etc. 

Malheureusement il y a un problème : la boucle est infinie ! Si on ne l’arrête pas, 
l’ordinateur va lire les instructions ad vitam œternam. Heureusement, les conditions 
vont nous aider. Lorsqu’on crée une boucle, on indique une condition pour sortir de la 
boucle. 



La boucle for 

La boucle for est là pour vous éviter une luxation du poignet. Voici sa syntaxe : 

1 for (début; fin; incrément) 

2 { 

3 //Une ou plusieurs instructions 

4 } 

Trois paramètres sont passés à la boucle for : 

- début représente la valeur initiale du compteur de boucle ; 

-fin représente la condition qui permet de décider si la boucle se poursuit ou se 
termine ; 

- incrément modifie la valeur du compteur de boucle à la fin de chaque tour de boucle. 

Tout ceci vous semble peut-être obscur. Rassurez- vous, un petit exemple va vite clarifier 
les choses. Considérez le code suivant : 

1 int compteur ; 

2 for (compteur = 0; compteur < 100; compteur++) 

3 { 

4 NSLog ( @ " Bon j our " ) ; 

5 } 

Lors de la première exécution de la boucle, la variable entière compteur est initialisée 
à 0. La condition compteur < 100 est alors vérifiée, puisque 0 < 100. L’instruction 
NSLog est exécutée, l’ordinateur repart au début de la boucle. 

Lors de la deuxième exécution de la boucle, le compteur est incrémenté de 1 (compteur++) 
Il a donc pour valeur 1. La condition étant vérifiée (1 < 100), l’instruction NSLog est 
de nouveau exécutée. 
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Ainsi de suite, jusqu’à ce que compteur soit égal à 100. Dans ce cas, la boucle for 
prend fin et le programme continue de s’exécuter. Si vous faites le compte, l’instruction 
NSLog aura été exécutée. . . 100 fois, ce qui est exactement l’effet recherché. 

Etant donné qu’une seule instruction est exécutée dans la boucle for, les accolades ne 
sont pas obligatoires. Dans notre exemple, vous auriez donc tout aussi bien pu écrire : 

1 for (compteur = 0; compteur < 100; compteur+t) 

2 NSLog (@ " Bon j our ") ; 

Que diriez- vous d’un peu de pratique ? 

Toujours dans votre projet test, cliquez sur ViewController .m dans le volet de navi- 
gation. Repérez la méthode viewDidLoad et complétez-la comme suit : 

1 - ( void ) viewDidLoad 

2 { 

3 [super viewDidLoad]; 

4 int compteur ; 

5 for (compteur = 0; compteur < 100; compteur++) 

6 NSLog (@ " Bon j our ") ; 

7 } 

Exécutez l’application en cliquant sur Run. Très rapidement, cent lignes contenant le 
mot « Bonjour » sont affichées dans le volet de débogage : 

Attaching to process 2440. 

[...] test [2440 : f 803] Bonjour 

[...] test [2440 : f 803] Bonjour 


La boucle while 

La boucle while est une variante de l’instruction for. Elle exécute une ou plusieurs 
instructions tant qu’une condition est vérifiée. Voici sa syntaxe : 

1 while ( condition) 

2 { 

3 //Une ou plusieurs instructions 

4 } 

Voyons comment résoudre notre problème précédent avec une boucle while. 

1 int compteur = 0; 

2 while (compteur < 100) 

3 { 

4 NSLog (@ " Bon j our ") ; 

5 compteur++; 

6 } 

La première instruction initialise à 0 la variable compteur. 
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La boucle while se poursuit jusqu’à ce que la variable compteur soit supérieure ou 
égale à 100 (while (compteur < 100)). Lors de l’entrée dans la boucle, compteur 
vaut 0. 

Les instructions entre les accolades sont donc exécutées : la première affiche le texte 
« Bonjour », la deuxième incrémente d’un la variable compteur, qui vaut alors 1. 

Après l’incrémentation, la condition compteur < 100 est toujours vérifiée, puisque 
compteur vaut 1. Les instructions à l’intérieur des accolades sont donc exécutées une 
nouvelle fois. 

Ainsi de suite jusqu’à ce que compteur soit égal à 100. 

N’hésitez pas à tester le fonctionnement de la boucle while. Dans votre projet test, 
repérez la méthode viewDidLoad et complétez-la comme suit : 


1 

2 

3 

4 

5 

6 

7 

8 
9 

10 


- (void) viewDidLoad 

{ 

[super viewDidLoad]; 
int compteur = 0; 
while (compteur < 100) 
{ 

NSLog ( @ " Bon j our " ) ; 
compteur ++ ; 

} 


Exécutez l’application en cliquant sur Run pour constater que cent lignes contenant le 
mot « Bonjour » sont affichées dans le volet de débogage. 

Vous pouvez vous amuser à modifier la condition initiale du compteur (ligne 4) et la 
limite supérieure du compteur (ligne 5). Relancez l’application pour voir l’effet résul- 
tant. 

Attention à ne pas créer une boucle infinie, ou simplement trop grosse : 
répéter un mot 100 fois est facile pour votre ordinateur; le répéter 100 000 
000 devient déjà plus difficile pour lui. Et bien souvent il plante. 



La boucle do while 

La boucle do while est une variante de l’instruction while. Mais ici, la condition 
est testée après l’exécution des instructions entre accolades. Dans tous les cas, les 
instructions entre les accolades seront donc exécutées au moins une fois. Voici la syntaxe 
de cette instruction : 

î do 

2 { 

3 //Une ou plusieurs instructions 

4 } while (condition) ; 
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Si on voulait adapter notre exemple précédent, voici comment il faudrait faire avec une 
boucle do while : 

1 int compteur = 0; 

2 do 

3 { 

4 NSLog (@ " Bon j our " ) ; 

5 compteur++; 

6 } while (compteur < 100) ; 

La première instruction initialise la variable compteur à 0. Les instructions entre les 
accolades sont alors exécutées une première fois : le mot « Bonjour » est affiché avec la 
fonction NSLogO et la variable compteur est incrémentée de 1. 

La condition à la suite du while est alors examinée. Après la première exécution des 
instructions entre les accolades, compteur vaut 1. Il est donc bien inférieur à 100 et la 
boucle se poursuit. Ainsi de suite jusqu’à ce que compteur devienne égal à 100. 


Fonctions 


Une fonction peut être comparée à une boîte dont l’intérieur ne peut être vu. On 
lui fournit (éventuellement) une ou plusieurs données, elle effectue un traitement et 
retourne (éventuellement) une ou plusieurs autres données (figure 5.2). 


Données 
en entrée 


Fonction 

Traitement des données 


Données 
en sortie 


Figure 5.2 - Schéma de fonctionnement d’une fonction 

Une fonction consiste donc en un ensemble d’instructions qui effectuent un traitement 
et transforment les données qui lui sont fournies en d’autres données. 

Découper le code d’une application en plusieurs fonctions présente plusieurs avantages : 
chaque fonction étant indépendante du reste du code, il est facile de la tester et de la 
faire évoluer au grès des différentes versions de l’application. 

Pour déclarer une fonction, vous utiliserez la syntaxe suivante : 

1 type nom ( paramè très ) 

2 { 

3 //Une ou plusieurs instructions 

4 return retour; 

5 } 


Où : 

- type indique le type de la donnée retournée par la fonction (int, f loat, etc.) ; 
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- nom est le nom de la fonction ; 

- paramètres représente les éventuelles données fournies à la fonction ; 

- retour représente la donnée renvoyée par la fonction. 

La fonction nom utilise le ou les paramètres qui lui sont fournis pour effectuer un 
traitement et retourner la donnée retour. 

L’appel d’une fonction n’a rien de bien compliqué : il suffit d’indiquer son nom, éven- 
tuellement suivi des paramètres qui doivent lui être passés. Si la fonction renvoie une 
valeur, vous l’affecterez à une variable du même type que la valeur renvoyée. 

À titre d’exemple, la fonction ttc ci-après renvoie le prix TTC correspondant au prix 
HT qui lui est passé. Le prix HT et le prix TTC sont de type f loat. 

1 float ttc(float ht) 

2 { 

3 return ht * 1.196; 

4 } 

Ici, un paramètre de type float doit être fourni à la fonction (le prix HT), qui renvoie 
une valeur de type float. L’instruction utilisée sera donc du type suivant (ici, nous 
calculons la valeur TTC correspondant à un prix HT de 100) : 

l| float lePrixTTC = ttc(100); 

Il est possible d’aller plus loin ! Supposons que la fonction ttc doive calculer deux types 
de prix TTC : un avec une TVA de 5,5 %, un autre avec une TVA de 19,6 %. Comment 
devriez-vous compléter la fonction ttc précédente? Je vous laisse réfléchir. 


Si c’est vraiment trop difficile pour vous, je vais vous mettre sur la voie. 

- La fonction va avoir besoin de connaître le prix HT et la TVA à appliquer. Ces 
éléments seront passés à la fonction sous la forme de paramètres, donc entre les 
parenthèses. La TVA peut être fournie à la fonction telle quelle, au format float, 
ou représentée par un nombre int, qui pourrait valoir 1 dans le cas d’une TVA à 
5,5 % et 2 dans le cas d’une TVA à 19,6 %. 

- Dans la fonction, il faudra effectuer un calcul ou un autre en fonction du taux de 
TVA à appliquer. Une instruction if semble donc tout à fait appropriée. 

Cette fois-ci, je vous laisse vraiment réfléchir. Vous avez tous les éléments pour écrire 

cette fonction. 

Voici le code que je vous propose : 

1 float ttc(float ht, int tva) 

2 { 

3 if (tva==l) 

4 return ht * 1.055; 

5 else 

6 return ht * 1.196; 

7 } 
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O Le code que je vous propose n'est pas le code. En programmation, il y a 
différentes façons d'arriver à un même résultat. Si votre code diffère du mien 
mais qu'il fait la même chose, c'est très bien. 

La fonction ttc a maintenant deux paramètres : le prix HT et la TVA. Le deuxième 
paramètre est de type int. S’il est égal à 1, la fonction ttc renverra un prix TTC 
calculé avec une TVA de 5,5 %. Dans tous les autres cas, la fonction ttc renverra un 
prix TTC calculé avec une TVA de 19,6 %. 

Et pour appeler la fonction : 

prixl = ttc (100, 1); //Prix HT de 100 et TVA à 5 , 5‘/. 

pr ix2 = ttc (100, 2); //Prix HT de 100 et TVA à 19,6’/, 

Une fonction peut ne pas avoir de paramètre et peut aussi ne rien retourner. 
Dans ce cas, le mot-clé void est utilisé pour remplacer les paramètres et/ou 
le retour. 

Par exemple, une fonction qui affiche le mot « Bonjour » dans le volet de débogage 
ne demande aucun paramètre et ne retourne aucune valeur. Elle pourrait avoir l’allure 
suivante : 

1 void bon j our ( void ) 

2 { 

3 NSLog (@ " Bon j our \n " ) ; 

4 } 


En résumé 

- Pour comparer des valeurs entre elles, on utilise des opérateurs logiques. 

- Pour tester une condition, on utilise if, else if et else. 

- Il est possible d’effectuer plusieurs conditions dans un test, en séparant ces conditions 
par un opérateur logique. 

- switch est équivalent à if . . . elseif . . . else. . .. Cela permet de comparer une 
variable avec plusieurs valeurs et d’exécuter une ou plusieurs instructions en consé- 
quence. 

- Pour répéter un certain nombre de fois une ou plusieurs instructions, vous utiliserez 
une boucle for, while ou do while. La boucle for est particulièrement bien adaptée 
lorsque l’on connaît le nombre d’itérations de la boucle. Les instructions while et do 
while prennent fin lorsqu’une condition logique est vérifiée. 

- Une fonction consiste en un ensemble d’instructions qui effectuent un traitement et 
transforment les données qui lui sont fournies en d’autres données. Pour définir une 
fonction, précisez son type, la ou les variables qui lui sont passées en paramètre et 
utilisez return pour retourner une valeur. Pour appeler une fonction, indiquez son 
nom et passez-lui une ou plusieurs variables entre parenthèses. 
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îhapitre 


6 


La programmation orientée objet 


Difficulté : —M 

D ans ce chapitre, vous allez dans un premier temps découvrir ce qui se cache derrière la 
programmation orientée objet (P00). Vous verrez ensuite comment mettre en oeuvre 
ce type de programmation en utilisant le langage Objective-C. 

La programmation orientée objet est une notion difficile à comprendre, aussi n'hésitez pas 
à lire ce chapitre plusieurs fois, à tête reposée. Vous verrez, cela devrait finir par rentrer I 
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Qu’est-ce que la programmation orientée objet ? 

Dans la programmation « traditionnelle », les programmes sont constitués d’un en- 
semble d’instructions qui s’exécutent les unes à la suite des autres (voir figure 6.1). 


c 

c 

c 

c 


Instruction 

Instruction 

Instruction 

Instruction 

etc. 


1 

2 

3 

4 


Figure 6.1 - Les instructions s’exécutent les unes à la suite des autres 

Dans la plupart des programmes, on définit une boucle qui ne fait rien d’autre qu’at- 
tendre l’arrivée d’un événement. Par exemple, la fin d’un calcul, un changement d’heure, 
un clic souris ou un autre type d’événement quelconque. Si aucun événement ne se pro- 
duit, la boucle se contente d’attendre, encore et encore. C’est pourquoi on l’appelle 
souvent « boucle d’attente ». Si un événement survient, il est identifié et traité en 
conséquence. La figure 6.2 illustre mes propos. 



Figure 6.2 - Dans la plupart des programmes, on attend un événement 
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Dans la programmation orientée objet, les programmes sont constitués d’un ensemble 
de blocs de code indépendants appelés objets. Chaque objet contient sa propre boucle 
d’attente. Lorsqu’un événement concernant un objet particulier survient, c’est à cet 
objet de traiter l’événement, comme le montre la figure 6.3. 



Figure 6.3 - Avec la POO, ce sont les objets qui traitent les événements 

Les langages orientés objet utilisent plusieurs termes techniques bien particuliers. Pour 
vous aider à les appréhender, je vais utiliser une analogie en me basant sur des objets 
courants de la vie de tous les jours : des voitures. 

Une voiture est définie par un ensemble de caractéristiques : modèle et couleur entre 
autres. Elle est fabriquée dans une usine. Lors de la fabrication, une ou plusieurs options 
sont ajoutées au modèle de base. 

Dans un langage orienté objet : 

- l’usine est une classe : c’est elle qui fabrique les objets ; 

- la voiture est un objet ; 

- les caractéristiques de la voiture sont des propriétés ; 

- les options sont des méthodes de la classe Usine. 

Je vous ai fait un schéma en figure 6.4 pour vous aider à mieux visualiser tout ça. 

Maintenant que vous avez le vocabulaire nécessaire, nous allons rentrer dans le vif du 
sujet. 
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Les objets "Voitures" 



La classe "Usine” 



Les propriétés de 
chaque voiture : 

- modèle 

- couleur 


La méthode 
"Pare-brise teinté" 



Figure 6.4 - Une voiture est un objet 
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Définir une classe 


Revenons au petit monde des devices Apple. Une application iOS est bâtie autour 
d’une classe qui contient un ensemble d’objets, de propriétés (qui représentent l’état 
des objets) et de méthodes (qui régissent le fonctionnement des objets) (voir figure 6.5) 


0 

«A 

(A 

ça 

o 

o 

£ 

£ 

II 




etc. 


Figure 6.5 - Une application iOS est bâtie autour d’une classe qui contient un ensemble 
d’objets, de propriétés et de méthodes 


Supposons que vous vouliez définir la classe maClasse (oui, je sais, c’est très original !). 
Vous devrez agir dans deux fichiers distincts : maClasse. h et maClasse. m. 

- maClasse. h est un fichier d’en-têtes. Il est utilisé pour déclarer les éléments mani- 
pulés dans le code. 

- maClasse. m contient le code source de l’application. 


79 


CHAPITRE 6. LA PROGRAMMATION ORIENTEE OBJET 


Le fichier .h 

Pour interagir avec ses utilisateurs, une application utilise une interface. Dans une 
application iOS, cette interface peut contenir du texte, des images, des vidéos, des 
boutons et bien d’autres choses encore. En tant que programmeur, vous devrez utiliser 
des classes pour définir ces différents éléments. Bien qu’il soit possible de définir à 
partir de zéro tous ces éléments (forme, ombrage, couleur, comportement sur l’écran 
etc.), vous préférerez sans aucun doute utiliser des classes toutes faites. Pour faciliter la 
vie des développeurs, Apple a eu la bonne idée de regrouper ces classes dans une sorte 
de boîte à outils (on dit aussi framework) appelée UIKit. C’est par son intermédiaire 
que vous pourrez ajouter du texte, des images, des boutons, des vidéos, etc. à vos 
applications. 

Pour établir le lien entre l’application en cours de développement et le framework 
UIKit, la première instruction d’un fichier .h doit toujours être la suivante : 

l| # import <UIKit/UIKit.h> 

Cette simple instruction donne accès à toutes les classes du framework UIKit. 

Les lignes qui suivent l’instruction #import définissent le nom et le type de l’application, 
ainsi que les variables utilisées dans l’application : 

1 ©interface nom : type 

2 { 

3 Une ou plusieurs variables 

4 } 

Où nom est le nom de l’application et type définit son type. 

Je sais pertinemment qu'arrivés à ce point du livre, vous n'avez aucune idée 
de ce que peut être le type d'une application iOS. N'ayez crainte, ce n'est 
pas important pour l'instant. L'exemple qui suit repose sur une application de 
type UlViewController. J'aurais tout aussi bien pu choisir une application 
de type « Schmoldu », mais j'ai préféré coller à la réalité en utilisant un type 
existant. 

Supposons donc que vous définissiez l’application test de type UlViewController. 
L’instruction Sinterface aura l’allure suivante : 

1 ©interface t e s t ViewCont r o lier : UlViewController 

2 { 

3 //Une ou plusieurs variables 

4 } 

Les variables définies entre les accolades sont appelées variables d’instance. 
Qu'est-ce encore que cela? 
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Quand vous développez une application iOS, vous définissez une nouvelle classe. Lorsque 
l’application est lancée, on dit qu’une « instance de la classe » est créée. Cela signifie 
qu’un objet de cette classe est créé. Les variables d’instance sont propres à cette ins- 
tance : si vous lancez deux fois l’application, les variables utilisées dans la première 
instance ne seront pas liées à la seconde, et inversement. Si vous avez du mal à com- 
prendre, la figure 6.6 devrait vous éclairer. 



Figure 6.6 - Chaque instance de classe a des variables qui lui sont propres 


Voici un exemple de fichier d’en-têtes .h : 


1 

2 

3 

4 

5 

6 
7 


# import CUIKit/UIKit .h> 

©interface Voiture : MSObject { 
NSString* modèle; 

NSString* couleur; 

} 

©end 


La classe a pour nom Voiture. Le fichier qui définit l’interface a donc pour nom 
Voiture.fi. 

La classe Voiture possède deux variables d’instance NSString : modèle et couleur. 



Pas si vite ! Qu'est-ce que signifie NSString et pourquoi y a-t-il un astérisque 
après ce mot ? 


NSString représente le type des variables modèle et couleur. Il s’agit d’un type per- 
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mettant de manipuler des chaînes de caractères. L’astérisque indique que les variables 
modèle et couleur sont des pointeurs de NSString. Elles contiendront donc l’adresse 
des chaînes et non les chaînes elles-mêmes. Comme vous le verrez tout au long de ce 
livre, l’utilisation de pointeurs dans Objective-C est monnaie courante. 

Définir des variables d’instance, c’est bien, mais pouvoir y accéder, c’est mieux! En 
effet, les variables d’instance sont là pour mémoriser des données, et ces données doivent 
pouvoir être écrites dans les variables d’instance et lues depuis les variables d’instance. 

Pour accéder aux variables d’instance, nous allons ajouter des getters (pour connaître 
la valeur stockée dans les variables) et des setters (pour stocker des valeurs dans les 
variables et y accéder) : 

1 - ( NSString * ) modèle; 

2 - ( NSString * ) couleur; 

3 - (void) setModele : ( NSString *) input ; 

4 - (void) setCouleur: ( NSString *) input ; 


Les deux premières instructions sont des getters. Elles permettent de lire les valeurs sto- 
ckées dans les variables d’instance modèle et couleur ; en d’autres termes, de connaître 
le modèle et la couleur de la voiture. La valeur renvoyée est de type NSString. Au début 
de ces deux lignes, le signe - indique qu’il s’agit de méthodes d’instance. 

Les deux dernières lignes sont des setters. Elles permettent de stocker des valeurs dans 
les variables d’instance modèle et couleur, c’est-à-dire définir le modèle et la couleur 
de la voiture. Ici aussi, il s’agit de méthodes d’instance, d’où le signe - au début des 
instructions. Ces méthodes ne renvoient aucune valeur, ce qui explique le (void) au 
début des instructions. 


Le fichier d’en-têtes est maintenant complet. Voici les instructions qui le composent : 


1 # import <UIKit/UIKit.h> 

2 

3 ©interface Voiture : NSObject { 

4 NSString* modèle; 

5 NSString* couleur; 

6 } 

7 - (NSString*) modèle; 

8 - (NSString*) couleur; 

9 - (void) setModele: ( NSString *) input ; 

10 - (void) setCouleur: ( NSString *) input ; 

11 ©end 


Le fichier .m 

Nous allons maintenant implémenter (c’est-à-dire écrire le code de) la classe Voiture 
en définissant ses getters et ses setters dans le fichier Voiture. m. Je vous rappelle que 
les getters vont permettre de lire le contenu des variables d’instance et que les setters 
vont permettre de les modifier. 

Commençons par les getters. Le but du jeu est d’obtenir la valeur stockée dans les 
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variables d’instance modèle et couleur. Une simple instruction return fera donc l’af- 
faire : 

1 #import "Voiture. h" 

2 @ implement at i on Voiture 

3 - ( NSSt r ing * ) modèle { 

4 return modèle ; 

5 } 

6 - (NSString*) couleur { 

7 return couleur; 

8 } 

9 ®end 

Passons maintenant aux setters. Leur but est de modifier les valeurs contenues dans 
les variables d’instance modèle et couleur. Que pensez- vous du code suivant ? 

1 - (void) setModele : ( NSSt r ing * ) nouvModele { 

2 modèle = nouvModele ; 

3 } 

4 - (void) setCouleur : ( NSSt ring *) nouvC ouleur { 

5 couleur = nouvCouleur; 

6 } 

La version 4.2 de Xcode innove grandement en matière de gestion de la mé- 
moire. Dans les versions précédentes de Xcode, il était nécessaire de détruire 
les variables lorsqu'elles n'étaient plus utilisées. Je dois avouer que vous avez 
vraiment de la chance, car à partir de maintenant, cette étape n'est plus 
nécessaire et le code s'en trouve grandement simplifié. 



Vous devez encore écrire une méthode pour définir et initialiser les variables d’instance. 
Cette méthode est le constructeur de la classe. Elle pourrait contenir quelque chose 
comme ceci : 

1 - (id) init 

2 { 

3 if ( self = [super init] ) 

4 { 

5 [self setModele : <§ " Maserat i Spyder"]; 

6 [self set Couleur : @ " Rouge "] ; 

7 } 

8 return self ; 

9 } 

La première ligne identifie le constructeur. Ne cherchez pas à comprendre le pourquoi 
du comment : c’est la syntaxe à utiliser ! 

En observant les lignes 5 et 6, vous pouvez déduire que ces deux instructions affectent 
la valeur « Maserati Spyder » à la variable d’instance modèle en utilisant le setter 
setModele et la valeur « Rouge » à la variable d’instance couleur en utilisant le setter 
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setCouleur. Rien ne vous empêche de choisir d’autres valeurs par défaut, mais j’ai 
pensé que ce choix n’était pas dépourvu d’intérêt. 

La troisième ligne affecte le résultat de [super init] à self. 



Mais qu'est-ce que c'est que tout ce charabia? Des explications s'il vous 
plaît ! 


Le mot self identifie l’objet courant. Dans notre cas, une instance de la classe Voiture. 
Quant au mot super, il identifie la classe « parente », c’est-à-dire la classe à partir de 
laquelle la classe Voiture a été créée. Un simple coup d’œil au fichier Voiture. h nous 
montre que la classe parente de Voiture est NSObject : 


^interface Voiture 

} 


MSObject { 


[super init] exécute donc la méthode init de la classe parente. Ici, NSObject. Cette 
méthode initialise la classe Voiture. La valeur renvoyée est nil si un problème s’est 
produit pendant l’initialisation. Dans le cas contraire, l’adresse de l’objet Voiture est 
renvoyée. 



En théorie, cette adresse est identique à celle qui se trouve dans self. Mais 
il arrive quelques cas où cette adresse diffère. En l'affectant à l'objet self, 
on est sûr que self pointe sur l'objet Voiture. 


L’instruction if teste la valeur stockée dans self, c’est-à-dire la valeur retournée 
par [self init] . Si la valeur renvoyée est différente de nil, les variables d’instance 
peuvent être initialisées. Dans le cas contraire, il est inutile de poursuivre l’exécution 
puisque l’initialisation de la classe a échoué. 

J’espère que l’initialisation de la classe n’a maintenant plus aucun secret pour vous. 
N’hésitez pas à relire plusieurs fois les lignes qui précèdent jusqu’à ce que vous ayez bien 
compris. Ne vous en faites toutefois pas si vous ne comprenez pas encore parfaitement 
cette section. Cela viendra avec la pratique et vous n’en êtes encore qu’à vos premiers 
pas en programmation Objective-C. Et croyez-moi, c’est assurément la partie la plus 
difficile de votre apprentissage ! 

Allez, pour vous encourager, voici le code complet du fichier Voiture. m : 

1 #import "Voiture. h" 

2 @ implement at ion Voiture 

3 - (NSString*) modèle { 

4 return modèle ; 

5 } 

6 - ( NSString * ) couleur { 

7 return couleur; 

8 } 

9 - (void) setModele : ( NSString *) nouvModele 
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10 

11 

12 

13 

14 

15 

16 

17 

18 

19 

20 
21 
22 

23 

24 

25 

26 
27 


{ 

modèle = nouvModele ; 

> 

- (void) setCouleur : ( NSSt r ing * ) nouvC ouleur 

{ 

couleur = nouvCouleur; 

} 

- (id) init 

{ 

if ( self = [super init] ) 

{ 

[self setModele : @ " Ferrari 360"]; 

[self set Couleur Rouge "] ; 

} 

return self ; 

} 

®end 


Copier ce code 


[Code web : 364854 

V 


Définir des méthodes 

Les méthodes Objec.tive-C peuvent être attachées à une classe (méthode de classe) ou à 
une instance (méthode d’instance). Par exemple, stringWithFormat est une méthode 
de classe, rattachée à la classe NSString ; ou encore arrayWithArray est une méthode 
de classe, rattachée à la classe NSArray. 

Dans une de vos applications, vous pourriez être amenés à définir une méthode d’ins- 
tance nombreElementsTableau qui renverrait le nombre d’éléments du tableau qui lui 
est communiqué en paramètre. Voici la syntaxe générale permettant de déclarer une 
méthode : 

1 typeMethode (typeRetour) nomMethode : paramètres 

2 { 

3 //Une ou plusieurs instructions 

4 }; 

Où : 

- typeMethode vaut + pour une méthode de classe ou - pour une méthode d’instance ; 

- typeRetour est le type de l’objet retourné par la méthode; 

- nomMethode est le nom de la méthode ; 

- paramétrés correspond aux paramètres de la méthode, s’ils existent. Dans ce cas, 
ils sont constitués d’un ou de plusieurs couples (type) nom, où type est le type du 
paramètre et nom le nom du paramètre. 

Quelques exemples vont vous aider à y voir plus clair. L’instruction suivante déclare 
la méthode d’instance premierJour, qui renvoie le nom du premier jour de la semaine 
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lorsqu’on lui transmet une année (an) et un numéro de semaine (numSem) : 

1 | - (NSString *) premierJour : (int) an: (int) numSem; 

Cette autre instruction déclare la méthode de classe maMethode, qui ne renvoie rien 
(void) et qui ne demande aucun paramètre : 

1 | + (void) maMethode ; 

Enfin, cette dernière instruction déclare la méthode d’instance changePropriete, qui 
renvoie un booléen et qui admet deux paramètres : le nom de la propriété à modifier 
(prop) et la valeur à lui affecter (valeur) : 

l| - (BOOL) changePropriete: (NSString *)prop: (NSString *) valeur; 

Ces déclarations de méthodes sont purement hypothétiques. Elles ont un 
unique but : vous faire assimiler la syntaxe à utiliser pour définir des méthodes 
d'instance et de classe, sans et avec paramètres. Vous êtes certainement 
impatients de mettre en pratique tout cela. Eh bien, c'est justement ce que 
nous allons faire dans la section suivante. 



Appeler des méthodes 

Avant la pratique, un peu de théorie 

En Objective-C, appeler une méthode de classe revient à envoyer un message. Pour cela, 
on utilise une syntaxe un peu particulière : le nom de l’objet est placé entre crochets 
et on le fait suivre du nom de la méthode : 

1 | [objet méthode] ; 

Si la méthode demande une valeur en entrée, faites suivre le nom de la méthode par le 
caractère « : » et entrez la valeur après ce caractère : 

l| [objet méthode : entree] ; 

Si une méthode demande plusieurs paramètres, séparez-les par un espace et indiquez 
la valeur de ces paramètres après le caractère « : ». Ici par exemple, trois paramètres 
sont transmis à la méthode. Le premier suit le nom de la méthode (méthode : valeurl) 
et les deux autres sont précédés du nom du paramètre correspondant (param2 : valeur2 
et param3 : valeur3) : 

l| [objet méthode : valeurl param2 : valeur2 param3 : valeur3 ] ; 

Une méthode peut retourner un objet. Dans ce cas, vous pouvez le stocker dans une 
variable : 

1 I variable = [objet méthode] ; 
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Ou encore : 

l| variable = [objet méthode : entree ] ; 

Si la méthode retourne un objet, vous pouvez enchaîner plusieurs appels de méthodes 
(c’est d’ailleurs ce qu’on appelle un chaînage). Dans l’exemple suivant, le paramètre 
paraml est envoyé à la méthode méthode 1, et cette dernière est appliquée à l’objet 
objetl. Le résultat de la méthode est un objet auquel on applique la méthode methode2 
avec le paramètre param2 : 

l| [[objetl méthode 1 : paraml ] methode2 : param2] ; 

Je vous conseille de limiter le chaînage à deux appels de méthodes. Au-delà, 
le code perd rapidement en lisibilité. 

Si les choses ne sont pas très claires, examinez la figure 6.7. 



paramètre 


Objet 1 



Figure 6.7 - Le paramètre paraml est envoyé à la méthode méthode 1, et cette dernière 
est appliquée à l’objet objetl 


Je ne comprends rien à ce schéma ! Pourrais-je avoir quelques explications? 


Pour comprendre ce schéma, il suffit de suivre les flèches, de la gauche vers la droite. 

paramétré 1 est passé à la méthode 1 de l’objet 1. Cette méthode fait un traitement 
et retourne un résultat sous la forme d’un objet (la deuxième flèche rouge). La méthode 
2 de cet objet est exécutée, en lui passant le paramétré 2 en entrée (la troisième flèche 
rouge). Le résultat final est représenté par la quatrième flèche rouge. J’espère que c’est 
plus clair cette fois-ci. Dans le cas contraire, relisez ce qui vient d’être dit. Il n’y a rien 
de vraiment sorcier là-dedans. . . ;-) 
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Les méthodes ne sont pas l’apanage des objets : elles peuvent également être appliquées 
à des classes. Par exemple, pour créer une variable de type NSString, vous appliquerez 
la méthode string de la classe NSString : 

l| NSString* uneChaine [NSString string]; 

Cette instruction peut être simplifiée comme suit : 
l| NSString* uneChaine; 

Je suis sûr que vous préférez la deuxième syntaxe à la première. Je dois bien avouer 
que moi aussi ! 


Appel d’une méthode existante 

Et maintenant, un peu de pratique. Vous allez utiliser un peu de code Objective-C 
pour concaténer (coller si vous préférez) deux chaînes NSString et afficher le résultat 
dans la console du Simulateur iOS. 

Définissez un nouveau projet basé sur le modèle Single View Application et donnez- 
lui le nom « test ». Cliquez sur ViewController .m dans le volet de navigation et repérez 
la méthode viewDidLoad. Cette méthode est exécutée dès le démarrage de l’application. 
Vous allez y ajouter quelques instructions pour tester l’exécution de méthodes. La 
méthode viewDidLoad (ainsi que de nombreuses autres méthodes) a été générée par 
Xcode. Voici à quoi elle doit ressembler : 

1 - (void) viewDidLoad 

2 { 

3 [super viewDidLoad]; 

4 // Do any additional setup after loading the view, typically 

f rom a nib . 

5 } 


Le message [super viewDidLoad] exécute la méthode viewDidLoad de la classe pa- 
rente (super) de la classe en cours d’exécution. Etant donné que notre classe test 
hérite de la classe UlView, cette instruction va exécuter la méthode viewDidLoad de la 
classe UlView. 



Comme vous le verrez au fur et à mesure de votre apprentissage, cette tech- 
nique est des plus courantes. Juste pour vous en convaincre, examinez les 
autres méthodes générées par Xcode (viewDidUnoload, viewWillAppear, 
viewDidAppear, etc.). Chacune d'elles utilise un message similaire. 


La ligne de commentaire n’a aucune utilité. Vous pouvez la supprimer. Pour concaté- 
ner deux chaînes, vous utiliserez la méthode stringByAppendingString en envoyant 
un message du type suivant : [chainel stringByAppendingString: chaine2] ; où 
chainel et chaine2 sont les deux chaînes à concaténer. 

Complétez la méthode viewDidLoad comme suit : 
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1 - ( vo id ) viewDidLoad 

2 { 

3 [super viewDidLoad]; 

4 NSString* chaine = @"un 

5 chaine = [chaine s t r ingByAppendingSt ring : @ " texte "] ; 

6 NSLog (@ chaine ) ; 

7 } 

Exécutez l’application en cliquant sur l’icône Run. La figure 6.8 représente ce que vous 
devriez obtenir dans la console. 


AU Output t Clear BJ [73 71 

lype "show copymg" to see tue conditions. 

There is absolutely no warranty for GDB. Type "show 
warranty" for details. 

This GDB was configured as "x86_64-apple-darwin" . 

Attaching to process 1455. 

2011-10-25 11:00:50.278 test 1 1455 : f 803 ] un texte 




Figure 6.8 - Nos deux chaînes ont bien été concaténées 

Examinons les instructions utilisées dans la méthode viewDidLoad. 

La ligne 4 définit l’objet NSString chaine et lui affecte la valeur « un » : 

1 | NSString* chaine = @ " un 

La ligne 5 applique la méthode stringByAppendingString à l’objet NSString chaine 
en lui passant le paramètre « texte ». Le résultat est stocké dans l’objet chaine (chaine 

l| chaine = [chaine s tr ingByAppendingSt ring : 0 " texte "] ; 

Enfin, la ligne 6 affiche le contenu de l’objet chaine (c’est-à-dire « un texte ») : 
l| NSLog chaine ) ; 


Création et appel d’une méthode 

Vous venez d’apprendre à appeler la méthode stringByAppendingString. Cette mé- 
thode fait partie des méthodes standards de la classe NSString. Vous allez maintenant 
aller un peu plus loin en créant une méthode et en l’appelant. Cette méthode : 

1. aura pour nom « concat » ; 

2. recevra deux paramètres NSString ; 

3. renverra leur concaténation dans un objet NSString. 

Munis de toutes ces informations, vous devriez pouvoir définir le gabarit (c’est-à-dire 
l’allure) de la méthode : 

l| -(NSString*) concat :( NSString *) chl : ( NSString *) ch2 ; 
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Cliquez sur ViewController .h dans le volet de navigation et ajoutez ce gabarit dans 
le fichier d’en-têtes, après l’instruction Ointerf ace. 

Il n’y a rien de bien compliqué dans ce gabarit. Si vous ne comprenez pas comment 
il est construit, relisez la section « Définir des méthodes ». Le fichier d’en-têtes doit 
maintenant ressembler à ceci : 

1 # import <UIKit/UIKit.h> 

2 ©interface ViewController : UlViewController 

3 

4 -(NSString») concat : ( NSS t r ing * ) chl : ( NSSt r ing * ) ch2 ; 

5 

6 ©end 

Maintenant, vous allez écrire quelques lignes de code dans le fichier ViewController .m. 
Cliquez sur ce fichier dans le volet de navigation et définissez la méthode concat, juste 
au-dessous de l’instruction Oimplementation : 

1 -(NSString») concat :( NSS t ring *) chl : ( NSSt ring ») ch2 

2 { 

3 return [chl stringByAppendingString : ch2] ; 

4 } 

La première ligne reprend le gabarit de la fonction. 

La troisième ligne définit l’objet retourné par la méthode ( via return). Cet objet est 
le résultat de la concaténation de chl et ch2, passés en arguments. 

Et maintenant, modifiez la méthode viewDidLoad comme suit pour appeler la méthode 
concat et afficher le résultat retourné dans la console : 

1 - (void) viewDidLoad 

2 { 

3 [super viewDidLoad]; 

4 NSString» chaine = [self concat: ©"premier " : © " deuxi ème " ] ; 

5 NSLog (©"•/,©", chaine) ; 

6 } 

La ligne 4 définit le NSString chaine (NSString» chaine) et lui affecte la valeur re- 
tournée par la méthode concat, en lui passant les NSString « premier » et « deuxième ». 

Que signifie le mot self dans ce code? 


Il signifie que la méthode concat a été définie dans la classe courante, tout simplement. 

Enfin, la ligne 5 affiche le résultat retourné par concat dans la console. Exécutez 
l’application. La figure 6.9 représente ce que vous devriez obtenir dans la console. 
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Ail Output î 

Clear U H J 

lype "show copying to see the conditions. 

There is absolutely no warranty for GDB. 
warranty" for details. 

Type "show 

This GDB was configured as "x86_64-apple 
Attaching to process 2131. 

-darwin" . 

2011-10-25 11:45:21.086 test (2131 : f 803 ] 

premier deuxième 


N 


Figure 6.9 - Les deux chaînes ont bien été concaténées 

Crochet ou point ? 

Deux styles d’écriture peuvent être utilisés pour appeler une méthode : les crochets ou 
les points. À titre d’exemple, les deux instructions suivantes sont équivalentes : 

1 [voiture setCouleur : @ " rouge "] ; 

2 voiture . couleur = @"rouge"; 

Ces deux écritures font une seule et même action : elles appliquent la méthode couleur 
à l’objet voiture en lui passant l’entrée rouge. 

L'écriture « à point » ne fonctionne que pour les variables d'instance. 

Les deux lignes suivantes sont elles aussi équivalentes : 

1 laCouleur = [voiture couleur]; 

2 laCouleur = voiture . couleur ; 

Vous l’aurez compris, elles lisent la couleur de l’objet voiture et la stockent dans la 
variable laCouleur. 



Créer un objet 

La gestion mémoire d’un objet peut être automatique ou manuelle. Dans le premier cas, 
lorsque l’objet n’est plus utilisé, il est automatiquement retiré de la mémoire. Dans le 
deuxième cas, c’est à vous de le retirer de la mémoire pour éviter qu’elle ne se sature. À 
titre d’exemple, pour créer l’objet NSString maChaine avec une gestion automatique 
de la mémoire, vous utiliserez l’instruction suivante : 

l| NSString* maChaine = [NSString string]; 

Ou plus simplement : 
l| NSString* maChaine; 

Si vous préférez gérer manuellement l’objet NSString maChaine en mémoire, vous 
utiliserez l’instruction suivante : 
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l| NSString* maChaine = [[NSString alloc] init]; 

Examinons cette deuxième écriture. Dans un premier temps, la méthode alloc est 
appliquée à la classe NSString. Cette opération réserve un espace mémoire et instancie 
un objet NSString. Dans un deuxième temps, la méthode init est appliquée à cet 
objet pour l’initialiser et le rendre utilisable (ce n’est qu’après l’initialisation de l’objet 
que l’on peut lui appliquer des méthodes). 

Si nécessaire, il est possible d’affecter une valeur à un objet NSString. 

Voici l’instruction à utiliser si vous optez pour une gestion automatique de la mémoire : 

1 NSString* maChaine = [NSString str ingWithStr ing : @ "Une chaîne 
quelconque " ] ; 

Ou plus simplement : 

l| NSString* maChaine = ®"Une chaîne quelconque"; 

Et voici les instructions à utiliser si vous optez pour une gestion manuelle de la mé- 
moire : 

1 NSString* maChaine2 = [[NSString alloc] init]; 

2 maChaine2 = @"Une chaîne quelconque"; 



La gestion mémoire automatique ou manuelle ne se limite pas aux objets de 
classe NSString : vous pouvez utiliser des techniques similaires pour créer et 
instancier des objets d'une quelconque autre classe. 


Cycle de vie des objets 

Tout comme les êtres vivants, les objets utilisés dans une application iOS ont un cycle 
de vie. 

1. Création. 

2. Utilisation. 

3. Destruction. 

Une très bonne nouvelle : iOS 5 introduit un système nommé ARC ( Automatic Refe- 
rence Counting) qui automatise le cycle de vie des objets. Désormais, c’est le compi- 
lateur qui se charge de cette tâche ingrate qui consiste à détruire les objets une fois 
qu’ils ne sont plus utilisés. 

Je ne m’étendrai pas plus sur le sujet, mais sachez que vous échappez à des complica- 
tions aussi inutiles que dangereuses. 
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En résumé 

- En programmation orientée objet, les programmes sont constitués d’un ensemble de 
blocs de code indépendants appelés objets. Chaque objet contient sa propre boucle 
d’attente. Lorsqu’un événement concernant un objet particulier survient, c’est à cet 
objet de traiter l’événement. 

- Via l’instruction #import CUIKit/UIKit .h>, le fichier .h fait référence au frame- 
work UIKit. Il définit également l’interface de l’application, les variables d’instance, 
et leurs accesseurs (getters et setters). 

- Le fichier . m implémente les getters et les setters des objets utilisés dans l’application, 
ainsi qu’une ou plusieurs méthodes complémentaires pour effectuer les traitements 
demandés par l’application. 

- Les variables d’instance sont propres à une instance de classe. Si plusieurs instances 
sont exécutées, les variables n’entreront donc pas en conflit. 

- Les méthodes sont appelées par l’intermédiaire de messages de type [objet méthode] 
ou [objet méthode : entree] ;. Les méthodes peuvent être chaînées en imbriquant 
plusieurs messages : [[objetl méthode 1: paraml] methode2: param2] ; . 

- Pour appeler une méthode d’une variable d’instance, il est possible d’utiliser une 
syntaxe « à point ». Ainsi, [objet méthode] et objet .méthode sont équivalents. 

- Dans iOS 5, le système ARC ( Automatic Reference Counting ) automatise le cycle 
de vie des objets : désormais, c’est le compilateur qui se charge de détruire les objets 
une fois qu’ils ne sont plus utilisés. 
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Chapitre 


7 


Les principaux objets utilisés en 
Objective-C 


Difficulté : 


E n tant que programmeurs Objective-C, vous allez être amenés à dialoguer avec des 
méthodes de classes en leur envoyant des messages. Ce chapitre s'intéresse aux classes 
incontournables et aux méthodes qui vous seront les plus utiles. 
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Chaînes de caractères 


Une chaîne de caractères est une suite de zéro, un ou plusieurs caractères. Voici quelques 
exemples de chaînes de caractères : 


Ceci est une 

chaîne de 

caract ères 

123 est plus 

petit que 

456 

@ç/w & ! 




Dans une application destinée aux iPhone, iPod Touch ou iPad, les chaînes de caractères 
sont manipulées à travers la classe Cocoa Touch NSString : 

l| NSString *maChaine; 

Il se peut qu’un jour vous tombiez sur une variante de cette déclaration : 

1 NSString * maChaine ; 

2 (NSString*) maChaine; 

3 NSString* maChaine; 

Ces trois déclarations sont strictement équivalentes à celle que je viens de vous présen- 
ter. 

Si nécessaire, il est possible d’affecter une valeur à une chaîne lors de sa définition : 
l| NSString *maChaine = @"Ceci est une chaîne de caractères"; 

Avez- vous remarqué le signe @ avant le début de la chaîne? Il est là pour indiquer à 
Xcode que les caractères suivants sont une chaîne de caractères. 

La classe NSString permet de définir des chaînes constantes, c'est-à-dire dont 
le contenu ne varie pas. Si vous devez définir des chaînes dont le contenu et/ou 
la taille peuvent changer, vous utiliserez plutôt la classe NSMutableString. 
Pour l'instant, la classe NSString sera bien suffisante. Vous en apprendrez 
plus sur ces deux classes dans la suite de ce livre. 

Et maintenant, nous allons voir comment manipuler les chaînes de caractères en étu- 
diant quelques méthodes de la classe NSString. 



Tester l’égalité de deux NSString 

Il est souvent utile de comparer deux chaînes entre elles. Vous pensez peut-être qu’il 
suffit d’utiliser une instruction du type suivant : 

1 if (chainel == chaine2) 

2 { 

3 // Traitement 

4 } 
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Eh bien, ce serait trop simple! En fait, cette instruction compare non pas le contenu 
mais l’adresse des deux chaînes. Rappelez- vous, lorsque vous définissez une nouvelle 
chaîne, vous le faites en créant un pointeur : 

l| NSString *chainel; 

Heureusement, il existe une solution pour comparer simplement deux chaînes. Vous 
utiliserez pour cela la méthode isEqualToString de la classe NSString : 

1 if ([chainel isEqualToSt r ing : chaine2 ] ) 

2 { 

3 // Traitement 

4 } 

Si cette syntaxe vous laisse perplexes, jetez un œil à la section « Appeler des méthodes » 
du chapitre précédent (page 86) et tout deviendra plus clair. Pour ceux qui auraient la 
mémoire courte, les méthodes de classe sont appelées en utilisant la syntaxe suivante : 

l| [objet méthode : entrée] ; 

Dans le cas qui nous occupe, la méthode isEqualToString est appliquée à l’objet 
chainel en lui transmettant l’objet chaine2 en entrée. Cette méthode retourne la 
valeur TRUE si les deux chaînes sont égales, FALSE dans le cas contraire. 

Longueur d’un MSString 

La longueur d’une chaîne est obtenue avec la méthode length de la classe NSString. 
Voici un exemple d’utilisation de cette méthode : 

1 NSString *a = ®"ceci est une chaîne"; 

2 NSLog (@ " Longueur de la chaine : '/,i", [a length]); 

L’instruction NSLog affiche le texte suivant dans le volet de débogage : 

Longueur de la chaîne : 19 



Notez que les espaces sont comptées. Eh oui, ce sont aussi des caractères. 


Concaténer deux NSString 

Pour concaténer deux chaînes, c’est-à-dire pour les mettre bout à bout, vous utiliserez 
la méthode stringWithFormat : 


1 

2 

3 


NSString * chaine 1 =@" premi ère partie"; 
NSString *chaine2= @ " deuxième partie"; 
NSString *chaine3; 
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4 chaine3 = [NSString s tringWithFormat : © "*/, ©'/,©", chainel , chaine2 ] ; 

5 NSLog (©"'/,©", chaine3 ) ; 

Les trois premières instructions ne devraient pas vous poser de problème. Pour tous 
ceux qui pensent que la quatrième ligne est incompréhensible, faisons quelques étapes 
intermédiaires. L’objet NSString chaine3 a été défini à la ligne précédente. Pour lui 
affecter une valeur, il suffit de faire suivre son nom du signe = et de la valeur souhaitée : 
chaine3 = valeur;. 

La valeur est obtenue en utilisant la méthode stringWithFormat de la classe NSString. 
Le début de l’expression est donc tout à fait clair : [NSString stringWithFormat 

...]. 

La méthode stringWithFormat admet un paramètre de type NSString. Dans cet 
exemple, ce paramètre a pour valeur , chainel , chaine2. Le signe @ devant 

le premier guillemet indique que la suite est une chaîne de caractères. Quant aux °/ 0 @, ils 
se réfèrent aux éléments spécifiés juste après le deuxième guillemet. Ainsi, le premier 
”/ 0 @ est remplacé par chainel et le deuxième par chaine2. Le résultat renvoyé est la 
concaténation des deux chaînes. L’instruction NSLog affiche donc le texte suivant dans 
le volet de débogage : 


première partie deuxième partie 


Définir une chaîne pendant l’exécution d’une l’application 

Supposons que l’objet NSString maChaine soit défini et initialisé avec l’instruction 
suivante : 

l| NSString ♦maChaine = ©"Bonjour"; 

Pour initialiser un objet NSString à partir d’une chaîne de type char, vous utiliserez 
les instructions suivantes : 

1 char ♦chaineC; 

2 NSString * chaine Ob j C ; 

3 ... 

4 // Instructions qui initialisent la variable char chaineC 

5 ... 

6 chaineûbjC = [NSString stringWithString : chaineC]; 

Inversement, pour initialiser une chaîne de type char à partir d’un objet NSString, 
vous utiliserez les instructions suivantes : 

1 const char ♦chaineC ; 

2 NSString ♦chaineûbjC = ©"Bonjour"; 

3 chaineC = [chaineûbjC String]; 
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Parcourir un NSString, caractère par caractère 


Un jour ou l’autre, vous serez certainement confrontés à ce problème : comment isoler 
chacun des caractères contenus dans un objet NSString afin d’effectuer des comparai- 
sons ou de leur appliquer un traitement individuel ? La solution est des plus simples : 
il suffit d’appliquer de manière répétitive la méthode characterAt Index à la chaîne. 


1 

2 

3 

4 

5 

6 

7 

8 

9 

10 


NSString *chaine; 
chaine = @ " he llowor ld " ; 

int i = chaine . length ; // La variable i contient le nombre de 

caractères de la chaîne 
int j ; 

char uneLettre ; 

for(j=0; j < i ; j++) // Boucle de 0 à i en incrémentant j 

{ 

uneLettre = [chaine characterAt Index : j ] ; // Extraction d'un 

caractère de la chaîne 

NSLog(@"La lettre en position ’/,i est ’/,c ", j, uneLettre); 

} 


La figure 7.1 représente le résultat dans la fenêter de débogage. 


GNU gdb 6.3.50-20050815 (Apple version gdb-1518) (Sat Feb 12 02:52:12 UTC 2011) 
Copyright 2004 Free Software Foundation, Inc. 

GDB is free software, covered by the GNU General Public License, and you are 
welcome to change it and/or distribute copies of it under certain conditions. 
Type "show copying" to see the conditions. 


Attaching to process 981. 


1. Type "show warranty" 
.e-darwin" . 

for 

details 

La 

lettre 

en 

position 

0 

est 

h 

La 

lettre 

en 

position 

1 

est 

e 

La 

lettre 

en 

position 

2 

est 

l 

La 

lettre 

en 

position 

3 

est 

l 

La 

lettre 

en 

position 

4 

est 

0 

La 

lettre 

en 

position 

5 

est 

w 

La 

lettre 

en 

position 

6 

est 

0 

La 

lettre 

en 

position 

7 

est 

r 

La 

lettre 

en 

position 

8 

est 

l 

La 

lettre 

en 

position 

9 

est 

d 


Figure 7.1 - Le résultat s’affiche dans la fenêtre de débogage 


Nombres 

Nous allons ici parler des objets de classe NSNumber, qui peuvent laisser perplexe. En 
effet, pourquoi utiliser une classe dédiée à la manipulation des nombres alors que les 
types int, float, double, etc. sont déjà disponibles? 

Et pourtant, vous aurez besoin de la classe NSNumber dans plusieurs cas bien précis. 
Par exemple, pour convertir des types de données. Le type d’un objet NSNumber peut 
être facilement modifié en utilisant les méthodes f loatValue, doubleValue, intValue, 
longValue, etc. Ici par exemple, un nombre entier est converti en un nombre double 
avec la méthode doubleValue : 
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1 NSNumber *unEntier = [NSNumber numberWithlnteger : 23] ; 

2 float unDouble = [unEntier doubleValue] ; 

La première instruction définit l’objet unEntier de type NSNumber et l’initialise avec la 
valeur entière 23. La deuxième instruction définit la variable unDouble de type float 
et lui affecte la conversion en un double de l’objet unEntier. 

À la vue de ce code, vous vous sentez certainement désorientés. Ne vous en faites pas, 
tout deviendra plus clair au fur et à mesure de votre apprentissage. Pour l’instant, il 
vous suffit de savoir que les types numériques cohabitent avec la classe NSNumber, et 
que cette dernière est utile dans certains cas bien précis. 


Dates et heures 

Plusieurs classes sont associées à la manipulation des objets date et heure dans Objective- 
C : NSDate, NSCalendar, NSTimeZone, NSDateComponents, NSDateFormatter. Pour 
mieux appréhender ces différentes classes, rien de tel qu’un peu de code. 


Affichage de la date courante 


Ces quelques lignes de code affichent la date courante au format américain (en_US) et 
français (fr_FR) : 


î 

2 

3 

4 

5 

6 

7 

8 
9 

10 

11 

12 

13 

14 

15 

16 

17 

18 

19 

20 
21 


/* Définition de l'objet date et de sa mise en forme */ 

Il Au j ourd 1 hui 

NSDate ♦date = [NSDate date]; 

NSDateFormatter ♦miseEnForme = [[NSDateFormatter alloc] init]; 

// Aucun affichage de l'heure 

[miseEnForme setTi me Style : NSDateFormatterNoStyle] ; 

// Affichage de la date au format semi -abrégé 

[miseEnForme setDateStyle : NSDat e Format t erMediumS t y le ] ; 

/* Affichage de la date au format US *1 

NSLocale ♦usLocale = [[NSLocale alloc] init WithLo calel dent if ier 
:@"en_US"] ; 

[miseEnForme setLocale : usLocale] ; 

NSLog(@"Date au format '/,<§: [[miseEnForme locale] 

1 ocaleldent if ier ] , [miseEnForme stringFromDate : date] ) ; 

I* Affichage de la date au format FR *1 

NSLocale ♦frLocale = [[NSLocale alloc] init WithLo calel dent if ier 
: @ " f r _FR " ] ; 

[miseEnForme setLocale : frLocale] ; 

NSLog ( @ " Dat e au format */,@ : */,<§", [[miseEnForme locale] 

1 ocaleldent if ier ] , [miseEnForme stringFromDate : date] ) ; 
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> 


Et voici ce que ça donne dans la console : 


[. 

. ] test [1 527 

207] 

Date 

au format en_US : 

J un 7 , 

2011 

[. 

. ] test [1 527 

207] 

Date 

for locale fr_FR 

7 juin 

2011 


Copier ce code 
Code web : 534925 



Cette syntaxe est vraiment incroyable et j'ai peur d'être dépassé ! Est-ce que 
j'aurais raté un chapitre? 


Examinons le premier bloc d’instructions. La ligne 4 définit l’objet NSDate date (NSDate 
♦date) et lui affecte la date courante ([NSDate date]). 

1 | NSDate ♦date = [NSDate date] ; 

La ligne 5 définit l’objet miseEnForme de type NSDateFormatter. C’est par l’intermé- 
diaire de cet objet que l’on définira un format d’affichage pour la date. 

l| NSDateFormatter ♦miseEnForme = [[NSDateFormatter alloc] init]; 

La ligne 8 indique que l’heure ne doit pas être affichée. La méthode setTimeStyle est 
donc appliquée à l’objet miseEnForme en lui transmettant un paramètre : 

l| [miseEnForme s et TimeSt y le : NSDat eFormat t erNo St y le ] ; 

Enfin, la quatrième instruction donne le format d’affichage de la date. Les messages 
autorisés pour la méthode setDateStyle sont : 

- NSDateFormatterNoStyle 

- NSDateFormatterShortStyle 

- NSDateFormatterMediumStyle 

- NSDateFormatterLongStyle 

- NSDateFormatterFullStyle 

Je vous invite à modifier l’instruction en question afin d’observer les différents compor- 
tements de ces méthodes. 

l| [miseEnForme s etDat eSt y le : NSDat eFormat t erMediumSt y le ] ; 

Examinons maintenant le deuxième bloc d’instructions. La ligne 14 définit l’objet 
NSLocale usLocale et l’initialise au format en_US, c’est-à-dire anglais américain : 

1 NSLocale ♦usLocale = [[NSLocale alloc] ini tWi thL ocale Ident if ier 
: @ " en_US " ] ; 

La ligne suivante utilise la classe setLocale pour indiquer à l’objet NSDateFormatter 
miseEnForme que l’affichage devra se faire au format anglais américain : 

1 [miseEnForme setLocale : usLocale ] ; 
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Enfin, la ligne 16 affiche la date courante dans ce format. Le premier message entre 
crochets récupère l’identificateur de langue (en_US) et le deuxième la date au format 
miseEnForme : 

1 NSLog(@"Date au format ’/,<§: [[miseEnForme locale] 

1 ocaleldent if ier ] , [miseEnForme stringFromDate : date] ) ; 

Le troisième bloc d’instructions est très proche du deuxième, à ceci près qu’il demande 
l’affichage de la date au format français. 

Création d’une date relative à la date système 

La méthode initWithTimeliitervalSinceNow permet de créer un objet NSDate en lui 
appliquant un décalage par rapport à la date système. Le décalage peut être positif 
(pour définir une date postérieure à la date système) ou négatif (pour définir une date 
antérieure à la date système). Examinez le code suivant : 

1 NSDate * dat eC ourant e = [NSDate date]; //Aujourd'hui 

2 NSTimelnterval s econdesPar J our = 24 * 60 * 60; 

3 NSDate ♦demain = [[NSDate alloc] initWithTimelntervalSinceNow: 

s econdesPar J our ] ; 

4 NSDate *hier = [[NSDate alloc] initWithTimelntervalSinceNow : - 

s econdesPar J our ] ; 

La première ligne définit l’objet NSDate dateCourante et y mémorise la date sys- 
tème. La deuxième ligne définit l’objet NSTimelnterval secondesParJour et y mé- 
morise le nombre de secondes contenues dans une journée. La troisième ligne définit 
l’objet NSDate demain et y stocke la date système plus un jour. Pour cela, la mé- 
thode initWithTimelntervalSinceNow lui est appliquée en lui transmettant la valeur 
secondesParJour. L’objet demain est donc initialisé avec la date qui suit le jour cou- 
rant. La quatrième ligne est très proche de la troisième, mais ici, le paramètre passé 
à la méthode initWithTimelntervalSinceNow est égal à -secondesParJour. L’objet 
hier est donc initialisé avec la date qui précède le jour courant. 

Définition d’une date autre que la date système 

Pour définir une date différente de la date système, vous devez : 

1. définir et initialiser un objet NSDateComponents ; 

2. l’affecter à un objet NSDate via un objet NSCalendar. 

Tout ceci a l’air bien compliqué, mais vous allez voir qu’il n’en est rien en examinant 
le code suivant : 

1 // Définition d'un objet NSDateComponents 

2 NSDateComponents ♦nsDatePerso = [[NSDateComponents alloc] init 

] ; 

3 [nsDatePerso setYear : 2065] ; 
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4 

5 

6 
7 


9 


[nsDatePerso setMonth:8]; 

[nsDatePerso setDay:12]; 

// Création d'un objet NSDate et affectation de l'objet 
nsDatePerso défini précédemment 

NSDate *datePerso = [[NSCalendar currentCalendar ] 
dateFromComponents : nsDatePerso] ; 

NSLog (@ "Date utilisateur : datePerso); 


Voici le résultat affiché dans la console : 


[...] tes t [1 680 : 207] Date utilisateur : 2065-08-11 22:00:00 

+ 0000 


Comme vous le voyez, aucune mise en forme NSFormatter n’a été appliquée à l’objet 
datePerso. 

Examinons les instructions qui composent ce code. La première instruction définit 
l’objet NSDateComponents nsDatePerso et réserve son emplacement en mémoire : 

1 NSDateComponents ♦nsDatePerso = [[NSDateComponents alloc] init 

] ; 

Les trois instructions suivantes initialisent les composants année, mois et jour de cet 
objet. 

1 [nsDatePerso set Year : 2065 ] ; 

2 [nsDatePerso setMonth:8]; 

3 [nsDatePerso setDay:12]; 

Le deuxième bloc d’instructions définit un objet NSDate de nom datePerso (NSDate 
*datePerso). Cet objet est initialisé avec la date définie dans l’objet nsDatePerso 
(dateFromComponents : nsDatePerso) en passant par un objet NSCalendar ( [NSCalendar 
currentCalendar] ) : 

1 NSDate ♦datePerso = [[NSCalendar currentCalendar] 

dateFromComponents : nsDatePerso] ; 


Une variante pour définir une date autre que la date système 

Pour définir et initialiser un objet NSDate avec une date différente de la date sys- 
tème, il est également possible d’utiliser une chaîne de caractères. Cette technique 
est plus simple que la précédente. Elle consiste à passer en paramètre la chaîne qui 
contient la date à la méthode dateFromString, qui elle-même est appliquée à un objet 
NSDateFormatter : 


1 

2 

3 


NSDateFormatter^ df = [[NSDateFormatter alloc] init]; 
[df setDateFormat : @ " dd -MM - yyyy " ] ; 

NSDate tuneDate = [df dat eFr omS t r ing : @ " 12 -08 - 201 1 " ] ; 
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La première instruction définit l’objet NSDateFormatter df et lui réserve un emplace- 
ment en mémoire : 

l| NSDateFormatter^ df = [[NSDateFormatter alloc]init]; 

La deuxième instruction définit le format utilisé dans l’objet NSDateFormatter : 
l| [df s etDat eFormat : @ " dd -MM - yyyy " ] ; 

Enfin, la troisième instruction affecte une date à l’objet NSDate uneDate en transmet- 
tant une chaîne à la méthode dateFromString de l’objet NSDateFormlatter df : 

il NSDate ♦uneDate = [df dat eFr omSt r ing : 0 " 1 2 - 08 - 20 1 1 " ] ; 


Extraction des composants d’un objet NSDate 

Pour accéder aux composants (jour, mois, année, heure, minute et seconde) d’une date 
au format NSDate, vous devez utiliser la méthode components : fromDate: d’un objet 
NSCalendar dans lequel vous aurez stocké la date. 

À titre d’exemple, le code ci-dessous extrait le jour, le mois, l’année, l’heure, les minutes 
et les secondes de la date système et les affiche dans la console : 

1 NSDate *date = [NSDate date]; //Aujourd'hui 

2 NSCalendar ♦calendrier = [NSCalendar currentCalendar ] ; 

3 NSDat eComponent s ♦composants = [calendrier components :( 

NSYearCalendarUnit | NSMonthCalendarUnit | NSDayCalendarUnit 
I NSHourCalendarUnit | NSMinuteCalendarUnit | 
NSSecondCalendarUnit) fromDate :date] ; 

4 NSLog(@"Nous sommes le ’/,i / ’/,i / ’/,i", [composants day] , [ 

composants month] , [composants year] ) ; 

5 NSLog(@"Il est */,i : */,i : */,i", [composants hour] , [composants 

minute], [composants second]); 


> 


La première instruction crée l’objet NSDate date et y stocke la date système : 
l| NSDate ♦date = [NSDate date]; //Aujourd'hui 

La deuxième instruction crée l’objet NSCalendar calendrier : 
l| NSCalendar ♦calendrier = [NSCalendar currentCalendar]; 

La troisième instruction crée l’objet NSDateComponents composants et lui affecte les 
composants suivants de l’objet NSDate date : 

- année : NSYearCalendarUnit 

- mois : NSMonthCalendarUnit 

- jour : NSDayCalendarUnit 

- heure : NSHourCalendarUnit 


Copier ce code 
Code web : 977790 
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- minutes : NSMinuteCalendarUnit 

- secondes : NSSecondCalendarUnit 

Les deux dernières instructions affichent les composants de la date système dans la 
console, ce qui donne le résultat suivant : 


[. 

. ] test [1897 

207] 

Nous sommes 

le 7 / 6 / 2011 

[. 

. ] test [1 897 

207] 

Il est 16 

39 : 6 


Ajouter ou soustraire des dates 


Pour ajouter ou soustraire un certain nombre d’années, de mois et de jours à une date, 
vous devez créer un objet dateComponents, y stocker la valeur à ajouter ou soustraire 
et ensuite utiliser la méthode dateByAddingComponents : toDate pour ajuster la date 
d’origine. À titre d’exemple, nous allons ajouter 1 an, 3 mois et 10 jours à la date 
système et afficher le résultat dans la console. Voici le code utilisé : 


î 

2 

3 

4 

5 

6 
7 


NSDate ♦date = [NSDate date]; //Aujourd'hui 

NSDateComponents ♦leGap = [ [NSDateComponents alloc] init]; 

[leGap setYear : 1] ; 

[leGap setMonth:3]; 

[leGap setDay:10]; 

NSDate ♦nouvelleDate = [[NSCalendar currentCalendar] 

dateByAddingComponents : leGap toDate : date options : 0 ] ; 


9 

10 


NSLog (@ "Date système : */,<§", date); 

NSLog (@ " Nouvelle date : nouvelleDate ) ; 


La date système puis la nouvelle date sont affichées dans la console : 


[. 

.] 

test [1995 : 207] 

Date système : 

2011 -06-07 

14:59:53 +0000 

[. 

.] 

test [1995 : 207] 

Nouvelle date 

: 2012-09-17 

14:59:53 +0000 


Examinons les instructions utilisées. La première ligne définit l’objet NSDate date et 
y stocke la date système : 

1 | NSDate *date = [NSDate date] ; 

La deuxième ligne définit l’objet NSDateComponents leGap et réserve son emplacement 
en mémoire : 

l| NSDateComponents ♦leGap = [[NSDateComponents alloc] init]; 

Les trois lignes suivantes initialisent le décalage souhaité dans l’objet leGap : 


î 

2 

3 


[leGap setYear : 1] ; 
[leGap setMonth:3]; 
[leGap setDay:10]; 
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La nouvelle date est calculée dans l’objet NSDate nouvelleDate. Les composants défi- 
nis dans l’objet leGap sont ajoutés (dateByAddingComponents : leGap) à l’objet NSDate 
date (toDate: date) : 

1 NSDate ^nouvelleDate = [[NSCalendar currentCalendar ] 

dateByAddingComponents : leGap toDate : date options : 0 ] ; 


Calculer la différence entre deux dates 

Il est parfois nécessaire de calculer la différence entre deux dates. En Objective-C, cela 
se fait en appliquant les méthodes fromDate et toDate à un objet NSCalendar. Voici 
le code : 

1 NSDat eFormat t er * df = [ [NSDateFormatter alloc]init]; 

2 [df s etDat eFormat : @ " yyyy -MM - dd "] ; 

3 NSDate *dateA = [NSDate date]; //Aujourd'hui 

4 NSDate* dateB = [df dat eFr omSt r ing : @ " 201 1 - 01 - 01 " ] ; 

5 NSCalendarUnit calendrier = NSYearCalendarUnit | 

NSMonthCalendarUnit | NSDayCalendarUnit ; 

6 NSDat eComponent s ^différence = [[NSCalendar currentCalendar] 

components : calendrier fromDate : dateA toDate:dateB options:0 

] ; 

7 NSInteger mois = [différence month] ; 

8 NSInteger jours = [différence day] ; 

9 NSLog ( @ " D if f é rence entre les deux dates : */,i mois et */,i jours." 

, mois , j ours ) ; 


Copier ce code 

\ 

v Code web : 791255 

J 


Examinons ce code. Les deux premières instructions définissent et initialisent l’objet 
NSDateFormatter df : 

1 NSDateFormatter* df = [[NSDateFormatter alloc]init]; 

2 [df s etDat eFormat : @ " yyyy -MM - dd "] ; 

Les deux instructions suivantes stockent la date courante ainsi qu’une autre date (celle 
du 01/01/2011) dans les objets NSDate dateA et dateB : 

1 NSDate *dateA = [NSDate date]; //Aujourd'hui 

2 NSDate* dateB = [df dat eFr omSt r ing : @ " 201 1 - 01 - 01 " ] ; 

L’instruction suivante définit les composants qui seront utilisés pour calculer la diffé- 
rence entre les deux dates (ici les années, les mois et les jours) : 

1 NSCalendarUnit calendrier = NSYearCalendarUnit | 
NSMonthCalendarUnit | NSDayCalendarUnit; 

L’instruction suivante calcule la différence entre les deux dates. L’instruction est as- 
sez conséquente, alors prenez le temps de bien la comprendre. Dans la section « Ex- 
traction des composants d’un objet NSDate », vous avez appris à utiliser la méthode 
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components : fromDate pour extraire les composants (année, mois, jour, heures, mi- 
nutes, . . .) d’une date. Ici, nous allons utiliser la méthode components: fromDate: 
toDate: pour effectuer une soustraction entre deux dates et en extraire les compo- 
sants. 

Dans un premier temps, un objet NSCalendar est obtenu avec le message [NSCalendar 
currentCalendar] . 

La méthode components: fromDate: toDate: est alors exécutée. La différence entre 
les dates dateA et dateB est calculée (fromDate : dateA toDate : dateB), et seuls les 
composants définis dans l’objet NSCalendatUnit calendrier sont retournés. Le ré- 
sultat est stocké dans l’objet NSDateComponents différence : 

I NSDateComponents ♦différence = [[NSCalendar currentCalendar] 

components : calendrier fromDate : dateA toDate: dateB options :0 

] ; 

II ne reste plus qu’à extraire les composants ans, mois et jour du résultat et à les 
stocker dans des objets NSInteger : 

1 NSInteger ans = [différence year] ; 

2 NSInteger mois = [différence month] ; 

3 NSInteger jours = [différence day] ; 

Il ne reste plus qu’à les afficher dans la console : 

1 NSLog (@ " Dif f é rence entre les deux dates : ’/, ans ’/,i mois et '/,i 

j ours . " , ans , mois , j ours ) ; 


Temps nécessaire pour exécuter un bloc d’instructions 


Pendant la mise au point d’une application, il peut être utile de calculer le temps 
nécessaire à l’exécution d’un bloc de code. Voici comment procéder : 

1. définissez un objet NSDate et initialisez-le avec la date courante juste avant le 
bloc de code dont vous voulez tester le temps d’exécution ; 

2. exécutez le bloc de code ; 

3. appliquez la méthode timelntervalSinceNow à l’objet NSDate initialisé à l’étape 
1 et mémorisez le résultat dans un objet NSTimelnterval. 


Voici un exemple de code qui teste le temps nécessaire à l’affichage de 100 lignes dans 
la console : 


î 

2 

3 

4 

5 

6 
7 


NSDate ♦début = [NSDate date]; //Date courante 

//On affiche 100 lignes dans la console grâce à une boucle 
int compteur ; 

for (compteur = l; compteur < 100 ; compteur+t) 

{ 

NSLog (@ " abc " ) ; 
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8 } 

9 

10 NSTimelnt erval intervalle = [début t imelnt ervalSinceNow ] ; //On 

calcule le temps d'exécution. . . 

11 NSLog ( @ " Temps écoulé : 7.f", intervalle); //Et on l'affiche 
La figure 7.2 représente les dernières informations affichées dans la console. 


2011-07-04 

2011-07-04 

2011-07-04 

2011-07-04 

2011-07-04 

2011-07-04 

2011-07-04 

2011-07-04 

2011-07-04 

2011-07-04 

2011-07-04 

2011-07-04 

2011-07-04 

2011-07-04 

2011-07-04 

2011-07-04 

2011-07-04 

2011-07-04 

2011-07-04 


17:54:09. 

17:54:09. 

17:54:09. 

17:54:09. 

17:54:09. 

17:54:09. 

17:54:09. 

17:54:09. 

17:54:09. 

17:54:09. 

17:54:09. 

17:54:09. 

17:54:09. 

17:54:09. 

17:54:09. 

17:54:09. 

17:54:09. 

17:54:09. 

17:54:09. 
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833 test2 

833 test2 
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835 test2 
835 test2 

835 test2 

836 test2 

836 test2 

837 test2 

837 test2 

838 test2 
838 test2 
858 test2 

858 test2 

859 test2 

860 test2 

860 test2 

861 test2 
861 test2 


(1249:207 

[1249:207 

[1249:207 

[1249:207 

(1249:207 

(1249:207 

[1249:207 

[1249:207 

[1249:207 

[1249:207 

[1249:207 

[1249:207 

[1249:207 

[1249:207 

[1249:207 

(1249:207 

[1249:207 

[1249:207 
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doc 

abc 

abc 

abc 

abc 

abc 

abc 

abc 

abc 

abc 

abc 

abc 

abc 

abc 

abc 

abc 

abc 

abc 

abc 

Temps écoulé en secondes : 


-0.105148 


0 


Figure 7.2 - On calcul le temps que prennent 100 lignes à s’afficher dans la console 


Tableaux 


La classe NSArray est dédiée à la manipulation de tableaux (un tableau est un assem- 
blage d’objets quelconques : c’est une façon de les ranger, comme dans une armoire). 
En programmation, on parle aussi d’array (d’où le nom de la classe NSArray). 



Les tableaux Objective-C sont de taille fixe, mais vous pouvez cependant les 
réallouer pour obtenir un nombre d'éléments différent. 


Définir et initialiser un tableau 

Pour créer un tableau contenant une chaîne de caractères, vous utiliserez l’instruction 
suivante : 

l| NSArray * monTableau = [NSArray arrayWithOb j ect : @ " premier "] ; 

Pour créer un tableau contenant un entier, vous utiliserez l’instruction suivante : 

1 NSArray * monTableau = [NSArray arrayWithOb j ect : [NSNumber 
numberWithlnt : 10]]; 

Pour créer un tableau contenant plusieurs chaînes de caractères, vous utiliserez l’ins- 
truction suivante : 
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1 NSArray *monTableau = [NSArray arrayWithOb j ect s premier ", @ " 

deuxième" , @ " troisième " , @ " quatr i ème " , nil] ; 

Le dernier élément du tableau doit avoir pour valeur nil. 

Enfin, pour créer un tableau à partir d’un autre tableau, vous utiliserez l’instruction 
suivante : 

il NSArray *monTableau2 = [NSArray arrayWithArray : monTableaul ] ; 



Accéder aux objets contenus dans un tableau 

Plusieurs méthodes très pratiques permettent d’accéder aux informations contenues 

dans un objet NSArray. 

- containsûbject renvoie la valeur true si le tableau contient au moins un objet. Il 
renvoie la valeur f aise dans le cas contraire. 

- count retourne le nombre d’objets du tableau. 

- objectAtlndex retourne l’objet situé à l’index (c’est-à-dire à la position) spécifié 
dans le tableau. 

- lastObject retourne le dernier objet contenu dans le tableau, c’est-à-dire celui dont 
l’index est le plus élevé. 

Par convention, le premier élément d'un tableau Objective-C se trouve à la 
position 0. On dit que son index est 0. Le deuxième élément se trouve à la 
position 1. Son index est 1. Ainsi de suite jusqu'au dernier élément. 



Pour clarifier ces méthodes, rien de tel que quelques exemples : 


1 

2 

3 

4 

5 

6 

7 

8 
9 

10 

11 

12 

13 

14 


NSArray *monTableau = [NSArray arrayWithOb j ect s : @ " premier ", @ " 
deuxième" , @ " troisième " , @ " quatrième " , nil] ; 

NSLog (<§"*/, @ " , monT ableau ) ; 

NSLog (@ " 0b j et qui se trouve à l'index 1 : */,<§", [monTableau 

ob j e et At Index : 1 ] ) ; 

if ([monTableau cont ains Obj ect : @ " premier "] ) 

NSLog (@ "L ' obj et premier a été trouvé dans le tableau"); 
else 

NSLog (@ "L ' obj et premier n'a pas été trouvé dans le tableau"); 

if ([monTableau cont ains Obj ect : @ " dixi ème "] ) 

NSLog (@ "L ' obj et dixième a été trouvé dans le tableau"); 
else 

NSLog (@ "L ' obj et dixième n'a pas été trouvé dans le tableau"); 
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15 


NSLog ( @ " Dernier objet 

]) ; 


du tableau 


[monTableau lastObject 


Examinons ces instructions. La première ligne définit l’objet NSArray monTableau 
et l’initialise avec quatre chaînes de caractères : premier, deuxième, troisième et 
quatrième : 

1 NSArray ^monTableau = [NSArray arr ayWithOb j e et s : premier ", @ " 

deuxième" , @ " trois i ème " , @ " quatrième ", nil ] ; 

La deuxième instruction (NSLog(@"°/ 0 @" .monTableau) ;) affiche le contenu du tableau 
dans la console. 

La troisième instruction affiche l’objet qui se trouve en position 1 (le deuxième donc, 
puisque l’index commence à 0) : 

1 NSLog ( @ " 0b j et qui se trouve à l’index 1 : [monTableau 

objectAtlndex : 1] ) ; 

Et voici les informations retournées dans la console : 

[...] test [109 5 : 207] Objet qui se trouve à l’index 1 : deuxième 


Le premier bloc if else utilise la méthode containsûbject pour tester la présence 
de l’objet premier dans le tableau et affiche un message en conséquence : 

1 if ([monTableau cont ains Obj ect : @ " premier "] ) 

2 NSLog ( @ " L ’ obj et premier a été trouvé dans le tableau"); 

3 else 

4 NSLog ( @ " L ’ obj et premier n’a pas été trouvé dans le tableau"); 

Ici, l’objet premier faisant partie du tableau, voici ce qu’affiche la console : 

[...] test [109 5 : 207] L’objet premier a été trouvé dans le 
tableau 


Le bloc if else suivant utilise la méthode containsûbject pour tester la présence de 
l’objet dixième dans le tableau et afficher un message en conséquence : 

1 if ([monTableau cont ains Obj ect : @ " dixi ème "] ) 

2 NSLog ( @ " L 1 obj et dixième a été trouvé dans le tableau"); 

3 else 

4 NSLog ( @ " L 1 obj et dixième n’a pas été trouvé dans le tableau"); 

L’objet dixième ne faisant pas partie du tableau, voici ce qu’affiche la console : 

[...] test [109 5 : 207] L’objet dixième n’a pas été trouvé dans le 
tableau 


Enfin, la dernière instruction affiche le dernier objet du tableau : 

i 


NSLog ( @ " Dernier objet du tableau : [monTableau lastObject 

]) ; 
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Comme prévu, le dernier objet est la chaîne quatrième : 


[...] tes t [1 095 : 207] Dernier objet du tableau : quatrième 


Passer en revue les objets contenus dans un tableau 

Vous vous en doutez certainement, la lecture successive des différents objets contenus 
dans un tableau se fera dans une boucle. Les objets peuvent être retrouvés avec la 
méthode objectAtlndex ou avec la méthode objectEnumerator. Nous allons examiner 
tour à tour ces deux possibilités. 


Avec la méthode objectAtlndex 

1 NSArray *monTableau = [NSArray arrayWithOb j ect s premier ", @ " 

deuxième" , @ " troisième " quatrième " , nil] ; 

2 int nombreElements = [monTableau count] ; 

3 for (int i = 0; i < nombreElements; i++) 

4 { 

5 NSLog (@ " 0b j et de rang ‘/,i : */,@", i, [monTableau objectAtlndex: 

i]) ; 

6 } 

La première instruction définit l’objet NSArray monTableau et y stocke quatre chaînes 
de caractères. Je ne vous remets pas le code, à ce stade vous devriez avoir compris. 

La deuxième instruction définit l’entier nombreElements et y stocke le nombre d’élé- 
ments du tableau : 

l| int nombreElements = [monTableau count]; 

La boucle for exécute l’instruction NSLog () autant de fois que le tableau contient 
d’objets : 

l| for (int i = 0; i < nombreElements; i++) 

L’instruction NSLog de la ligne 5 accède aux éléments du tableau en passant l’index de 
la boucle à la méthode objectAtlndex et en l’appliquant à l’objet monTableau : 


1 NSLog (@ " Obj et de rang '/,i : i, [monTableau objectAtlndex: i 

]) ; 

Le résultat affiché dans la console est bien celui qu’on attendait : 


[. 

.] 

test2 [1417 : 207] 

Objet 

de 

rang 

0 

premier 

[. 

.] 

test2 [1417 : 207] 

Objet 

de 

rang 

1 

deuxième 

[. 

.] 

test2 [1417 : 207] 

Objet 

de 

rang 

2 

troisième 

[. 

.] 

test2 [1417 : 207] 

Objet 

de 

rang 

3 

quatrième 


Avec la méthode objectEnumerator 
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1 NSArray * monTableau = [NSArray arr ayWithOb j e et s : @ " premier ", @ " 

deuxième" , @ " trois i ême " , @ " quatrième ", nil ] ; 

2 NSEnumerator *enumer = [monTableau ob j ectEnumerator ] ; 

3 NSOb j ect * ob j ; 

4 while ((obj = [enumer nextObject]) != nil) 

5 { 

6 NSLog ( @ " Ob j et : */,<§", obj); 

7 } 

La première instruction définit l’objet NSArray monTableau et y stocke quatre chaînes 
de caractères. 

La deuxième instruction crée l’objet enumer de type NSEnumerator et l’initialise avec 
un énumérateur basé sur l’objet monTableau : 

l| NSEnumerator *enumer = [monTableau obj ectEnumerator ] ; 

Ce type d’objet permet de décrire très facilement des tableaux. Pour en savoir plus sur 
ce sujet, consultez l’aide en cliquant sur les mots NSEnumerator (1) et obj ectEnumerator 
(2), et si nécessaire en activant les icônes Hide or show the Utilities (3) et Show 
Quick Help (4), comme indiqué à la figure 7.3. 



Figure 7.3 - Consultez l’aide 

L’instruction suivante définit l’objet obj de type NSOb j ect : 
1 I NSOb j ect * obj ; 
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En appliquant la méthode nextObject à l’objet NSEirumerator enumer, on obtient 
tour à tour tous les objets stockés dans le tableau monTableau. Lorsque tout le tableau 
a été parcouru, la méthode nextObject renvoie la valeur nil. La façon la plus simple 
de passer en revue tout le contenu du tableau consiste à utiliser une boucle while : 

l| while ((obj = [enumer nextObject]) != nil) 

Si l’objet renvoyé par la méthode nextObject est différent de nil, il est affiché dans 
la console : 

l| NSLog (@ " Ob j et : obj); 


Dans le cas contraire, la boucle while prend fin. Voici le résultat affiché dans la console : 


[. 

.] 

test2 [1507 : 207] 

Objet 

premier 

[. 

.] 

test2 [1507 : 207] 

Objet 

deuxième 

[. 

.] 

test2 [1507 : 207] 

Objet 

troisième 

[. 

.] 

test2 [1507 : 207] 

Objet 

quatrième 



Il existe un deuxième type de tableau en Objective-C : le NSMutableArray. 
Comme son nom le laisse supposer, il permet de manipuler des tableaux 
de taille variable. Si cela vous intéresse, consultez la documentation of- 
ficielle. En particulier, voyez comment utiliser les méthodes addObject:, 
insertObject :atlndex: et removeObjectAtlndex: qui permettent res- 
pectivement d'ajouter un objet à la fin du tableau, d'ajouter un objet à une 
position de votre choix et de supprimer un objet. 


Lire la documentation 
Code web : 505214 


Dictionnaires 

Parfois, l’ordre dans lequel sont mémorisés les éléments importe peu. Ce qui importe 
plutôt, c’est d’associer chacun des objets mémorisés à un autre objet unique. Par 
exemple, il pourrait être intéressant de définir des couples nom/définition, ou encore 
nom/adresse. Les définitions ou adresses pourraient alors être retrouvées en fournissant 
le nom correspondant. 

Les classes NSDictionary et NSMutableDictionary répondent parfaitement à cette 
problématique. Vous utiliserez un dictionnaire NSDictionary lorsque les objets à mé- 
moriser sont immuables, c’est-à-dire lorsqu’ils ne sont pas modifiés après leur création 
et leur initialisation. Par contre, vous utiliserez un dictionnaire NSMutableDictionary 
lorsque les objets à mémoriser peuvent être modifiés après leur création et leur initia- 
lisation. 
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Création et initialisation d’un dictionnaire 

Voici les instructions à utiliser : 

1 NSDictionary ♦leDictionnaire = [NSDict ionary dictionary]; 

2 NSMutableDictionary * leD ict ionnaire = [NSMutableDictionary 

dictionary] ; 

Pour ajouter des éléments dans un dictionnaire, vous appliquerez la méthode setObject 
à l’objet NSDictionary ou NSMutableDictionary en lui transmettant le couple de va- 
leurs à mémoriser : 

1 [leDictionnaire setObject: ® " une définition" forKey: ®" une clé 

d'accès"] ; 

2 [leDictionnaire setObject: ®"une autre définition" forKey: @" 

une autre clé d'accès"]; 

Si vous le souhaitez, la méthode dictionaryWithObjectsAndKeys permet de regrouper 
la définition et l’initialisation d’un dictionnaire dans une seule instruction : 

1 NSDictionary ♦leDictionnaire = [NSDictionary 

dictionaryWithObjectsAndKeys: ®" Une définition", ©"une clé", 
®"Une autre définition", S"une autre clé", nil]; 

Comme vous pouvez le voir, les objets stockés dans le dictionnaire sont séparés entre 
eux par des virgules et la valeur nil identifie la fin du dictionnaire. 

Enfin, sachez qu’un dictionnaire peut être créé à partir de deux NSArray. Le premier 
doit contenir les objets à stocker (définitions ou adresses), le deuxième les clés associées 
(noms) : 

1 NSArray ♦lesObjets = [NSArray arrayWithOb j ect s : ©"une dé 

finition", ®"une autre définition", nil]; 

2 NSArray ♦lesCles = [NSArray arrayWithOb j ect s : 8"une clé", S"une 

autre clé", nil]; 

3 NSDictionary ♦leDictionnaire = [[NSDictionary alloc] 

initWithOb j e et s : lesObjets forKeys: lesCles]; 


Méthodes relatives aux dictionnaires 

Pour connaître le nombre d’entrées stockées dans un dictionnaire, il suffit d’appliquer 
la méthode count à l’objet dictionnaire : 

1 NSLog (©"Nombre d'entrées mémorisées dans le dictionnaire = */,i" 

, [leDictionnaire count]); 

Pour obtenir l’objet qui correspond à une clé donnée, vous utiliserez la méthode 
objectForKey : 

1 NSLog (©"La clé 'une clé' correspond à la chaîne = '*/,©'", [ 

leDictionnaire objectForKey: ©"une clé d'accès"]); 
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Enfin, vous pouvez utiliser les méthodes removeObjectForKey et removeAUObjects 
pour supprimer, respectivement, l’entrée dont la clé est spécifiée ou toutes les entrées 
du dictionnaire : 

1 [ leDict ionnair e removeObjectForKey: ®"une clé"]; 

2 [ leDict ionnair e removeAUObjects]; 


Un exemple de code 

Ce petit exemple de code commenté illustre les instructions dont nous venons de parler : 


9 

10 

11 

12 

13 

14 

15 

16 

17 

18 

19 

20 


//On crée un dictionnaire 

NSMutableDictionary * leDictionnaire = [NSMutableDictionary 
dictionary] ; 

//On remplit le dictionnaire avec des couples adresse/nom 

[leDictionnaire setObject: @"12 rue Guérin 75013 Paris" forKey: 

@"Pierre Jaquart "] ; 

[leDictionnaire setObject: @"26 rue de la Place 75002 Paris" 
forKey: @"Eric Courteau"]; 

[leDictionnaire setObject: @"115 rue des pêcheurs 75005 Paris" 
forKey: @" Jean Bertier"]; 

[leDictionnaire setObject: @"2 place Mayeur 75012 Paris" forKey 
: @" Placido Perez "] ; 

//On affiche le nombre d'entrées du dictionnaire 

NSLog (@"Nombre d'entrées mémorisées dans le dictionnaire : ’/,i" 

, [leDictionnaire count] ) ; 

//On affiche une des entrées du dictionnaire 

NSLog (@"Le nom 'Eric Courteau' correspond à l'adresse '*/,@'", [ 

leDictionnaire ob j ec t For Key : @"Eric Courteau"]); 

//On supprime une entrée du dictionnaire 

[leDictionnaire removeObjectForKey: @" Jean Bertier"]; 

//On affiche le nombre d'entrées du dictionnaire, après la 
suppression d'une des entrées 

NSLog (@"Nombre d'entrées mémorisées dans le dictionnaire : ’/,i" 

, [leDictionnaire count]); 


> 


Copier ce code 
Uode web : 533412 


Et voici ce qu’affiche la console : 


[ . . . ] test [2996 : f 803] 
dictionnaire : 4 

[ . . . ] test [2996 : f 803] 
adresse ’26 rue de 


Nombre d’entrées mémorisées dans le 

Le nom ’Eric Courteau’ correspond à 
la Place 75002 Paris ’ 


1 ’ 
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[...] test [2996 : f 803] Nombre d’entrées mémorisées dans le 
dictionnaire : 3 


Ensembles 

Dans les sections précédentes, vous avez fait connaissance avec les tableaux et les 
dictionnaires. Les tableaux permettent de stocker des objets dans un certain ordre. Ces 
derniers peuvent alors être retrouvés par leur index. Les dictionnaires définissent des 
couples valeurs/clés. Les valeurs sont retrouvées en spécifiant les clés correspondantes. 

Il existe une troisième façon de stocker des objets : en utilisant des ensembles, via la 
classe NSSet, vous pouvez mémoriser un empilement d’objets sans ordre particulier. 


Création et initialisation d’un ensemble 

Pour créer un ensemble qui contient un seul objet : 

1 NSSet * monEnsemble = [NSSet setWithOb j ec t : [NSNumber 
numberWithlnt : 2] ] ; 

Pour créer un ensemble à partir d’un tableau : 

l| NSSet * monEnsemble = [NSSet setWithArray : monlableau] ; 

Pour créer un ensemble qui contient plusieurs objets : 

1 NSSet * monEnsemble = [[NSSet alloc] ini tWi thOb j ec t s : @ " un " , @ " 
deux" , @ " trois " ,nil] ; 


Méthodes relatives aux ensembles 

Recherche d’un objet dans un ensemble 

La méthode containsûbject permet de savoir si un objet fait partie d’un ensemble. 
Si l’objet est trouvé, la valeur true est renvoyée par la méthode. Dans le cas contraire, 
c’est la valeur false qui est renvoyée. Ici, l’objet deux est recherché dans l’ensemble 
monEnsemble. Un texte est affiché dans la console s’il est trouvé : 

1 if ([monEnsemble c ont ains 0b j e et : @ " deux " ] ) 

2 { 

3 NSLog (@"La chaîne deux a été trouvée dans l'ensemble"); 

4 } 
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Récupération d’un objet dans un ensemble 

Pour récupérer un objet dans un ensemble, vous utiliserez la méthode member. Si l’objet 
est présent, il est renvoyé par la méthode. Dans le cas contraire, c’est la valeur nil qui 
est renvoyée. Ici, l’objet deux est recherché dans l’ensemble monEnsemble. S’il existe, 
il est affiché dans la console : 

1 id unMembre = [monEnsemble member :(<§" deux ")] ; 

2 if ( unMembre ! =nil ) 

3 { 

4 NSLog (@ " Ob j et */,<§", unMembre ) ; 

5 } 


Récupération des objets d’un ensemble 

La méthode allObjects permet de récupérer tous les objets d’un ensemble sous la 
forme d’un NSArray : 

l| NSArray *leTableau = [monEnsemble allObjects]; 

La méthode objectEnumerator permet de récupérer un NSEnumerator sur un en- 
semble : 

l| NSEnumerator *enumer = [monEnsemble objectEnumerator]; 

Enfin, la méthode anyObject permet de récupérer un objet quelconque d’un ensemble : 
il id unOb j etQuelconque = [monEnsemble anyObject]; 


En résumé 

- Les chaînes de caractères sont manipulées à travers la classe NSString. Pour définir 
une chaîne, utilisez l’instruction NSString *maChaine. 

- int, float, double, etc. ne sont pas les seuls types de données numériques. Vous 
pouvez aussi utiliser des objets de classe NSNumber dans certains cas particuliers, par 
exemple pour effectuer des conversions de données. 

- Les classes NSDate, NSCalendar, NSTimeZone, NSDateComponents et NSDateFormatter 
permettent de manipuler des objets date et heure. Vous pouvez définir une date en 
rapport (ou non) avec la date système, extraire les composantes d’un objet NSDate, 
ajouter ou soustraire des dates, calculer la différence entre deux dates, etc. 

- La classe NSArray est dédiée à la manipulation de tableaux. Lorsqu’un tableau a été 
défini, vous pouvez tester son contenu avec la méthode containsûbject, et accéder 
aux objets qui le composent avec les méthodes objectAtlndex et objectEnumerator. 

- Les classes NSDictionary et NSMutableDictionary permettent de définir des dic- 
tionnaires. Pour initialiser un dictionnaire, vous utiliserez les méthodes setObject, 
dictionnaryWithObjectAndKeys et initWithObjects. 
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- Pour mémoriser des objets en les empilant, vous utiliserez un ensemble. Lorsqu’un 
ensemble a été défini, vous pouvez tester si un objet en fait partie, récupérer un objet 
donné, un objet quelconque, tous les objets ou un énumérateur. 
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8 


TP : Un jeu de Mastermind 


Difficulté : 

V ous voici donc arrivés au premier TP! TP signifie « Travaux Pratiques ». En clair, 
vous allez pratiquer ce que nous venons de voir. Régulièrement, je vous ferai travailler 
grâce à ce genre d'exercices et vous allez vite voir que, mine de rien, vous en savez 
des choses. 

Évidemment, je ne vous demanderai jamais rien que vous ne soyez capables de faire. Enfin 
pas vraiment. . . Il se peut que cela arrive, mais dans ce cas je vous donnerai la marche à 
suivre pour parvenir à la fin du TP. Bon, vous êtes prêts? Alors allons-y! 
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Instructions pour réaliser le TP 

Dans ce premier programme, votre device va choisir un nombre de quatre chiffres au 
hasard. Vous devrez le trouver en un minimum d’essais en proposant des nombres de 
quatre chiffres. Pour chaque proposition, le nombre de chiffres bien placés sera indiqué. 
Le résultat attendu se trouve à la figure 8.1. 



Saurez-vous trouver le nombre de 
quatre chiffres que j'ai choisi ? 

Tentez votre chance [ 4331 


4321 

5678 

1234 


Bien placés : 1 
Bien placés : 1 
Bien placés : 0 


Choisir un autre nombre 



Figure 8.1 - Le rendu attendu de notre Mastermind 
Pour parvenir à ce résultat, vous devrez : 

1. définir une application basée sur le modèle Single View Application; 

2. créer l’interface de l’application dans Interface Builder; 

3. relier les éléments de l’interface au code Objective-C ; 

4. tirer au hasard un nombre de quatre chiffres ; 

5. afficher le clavier lorsque le joueur clique dans la zone de saisie et l’effacer lorsqu’il 
valide sa saisie en appuyant sur Retour ; 

6. écrire les instructions nécessaires pour comparer les nombres proposés par le 
joueur et le nombre à découvrir et afficher un message en conséquence. 

Normalement, seule l’étape 4 devrait vous poser un problème. Les autres ont déjà été 
vues ; si vous avez le moindre problème avec, n’hésitez pas à lire les chapitres précédents 
correspondants. 

Pour tirer un nombre aléatoire, nous utiliserons la fonction arc4random() , qui renvoie 
un nombre aléatoire compris entre 0 et 4 294 967 295. Sauf que nous voulons un nombre 
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de 4 chiffres, donc compris entre 1000 et 9999. Bref, on en est loin. Nous allons donc 
devoir ruser, grâce au modulo. Regardez le code suivant : 

l| arc4random() I, 9000 + 1000; 

arc4random() °L 9000 renvoie un nombre compris entre 0 et 8999. En lui ajoutant 
1000, le nombre est compris entre 1000 et 9999. 

L’affichage du clavier est automatique lorsque le joueur clique dans la zone de saisie. 
Par contre, ce sera à vous de faire disparaître le clavier lorsque le joueur validera la 
saisie en appuyant sur la touche Retour. Cette action sera accomplie en appelant la 
méthode resignFirstResponder de la classe sender. 

Je suis sûr que vous êtes pressés de commencer. Imaginez un peu, votre première 
application ! Alors, n’attendez plus, commencez dès maintenant. Et soyez assurés que 
je ne serai pas loin de vous. Si vous avez une difficulté quelconque, reportez-vous à la 
correction qui suit. J’ai détaillé chaque étape de façon à ce qu’aucun blocage ne vous 
empêche d’arriver au bout du TP. Cependant, il est tout à fait normal de passer un 
long moment à réfléchir à ce que vous devez faire. Vous pouvez même vous aider d’une 
feuille blanche et d’un stylo en mettant par écrit vos idées. 


Correction 

J’espère que vous n’avez pas eu trop de problèmes dans ce TP. Voici ma correction, 
dans laquelle je passe en revue tous les points qui auraient pu « coincer ». 

Création de l’application 

Dans Xcode, sélectionnez Create a new Xcode project dans la boîte de dialogue 
affichée au lancement du programme. Si aucune boîte de dialogue n’est affichée, lancez 
la commande New/New project dans le menu File. Dans la boîte de dialogue Choose a 
template for your new project, choisissez Single View Application puis cliquez 
sur Next. Donnez le nom mastermind à l’application, tapez test dans la zone de texte 
Company Identifier, cochez la case Use Storyboard et cliquez sur Next. Choisissez 
un dossier pour stocker l’application et validez en cliquant sur Create. Au bout de 
quelques instants, le squelette de l’application est créé. 

Définition de l’interface 

Sous le dossier mastermind, cliquez sur l’entrée mainStoryboard. storyboard dans la 
barre de navigation (volet gauche de l’application). Une interface désespérément vide 
est affichée dans la partie droite de la fenêtre (figure 8.2). Rassurez- vous, nous allons 
très vite la remplir. 

Dans la partie supérieure droite de la fenêtre (c’est-à-dire dans la barre d’outils), au- 
dessus du libellé View, cliquez sur l’icône Hide or Show the utilities (1) et cliquez 
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Figure 8.2 - L’interface est vide 


sur l’icône Show the Object Library (2) pour faire apparaître la bibliothèque, comme 
indiqué à la figure 8.3. 



mastermind 

U 2 Urqets. OS SDK S.O 

v j_j mastermind 

h AppDeleqate.h 
m AppDclegate.m 


h VlewController.h 
m VlcMConIrollci.nl 
► Support ing Flic» 

► mastermindTeit» 

► Framework» 

► £_J Products 


3 View Controllcr Stcne 


^ First Responder 
► (J View Controller 


M Objccts 


f 

D {} g « 

ts ^Tj fisTg) 


ÛJO« 


O© 




Figure 8.3 - Il faut afficher la librairie d’objets 

Ajoutez deux Label, un Text Field, un Text View et un Round Rect Button à l’in- 
terface, puis redimensionnez-les pour obtenir une disposition semblable à la figure 8.4. 
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CORRECTION 


ta 


Label 

Label 

Lorem ipsum dolor sit er élit lamet, 
consectetaur cillium adipisicing pecu, sed 
do elusmod tempor incididunt ut labore et 
dolore magna aliqua. Ut enim ad minim 
veniam, quis nostrud exercitation ullamco 
laboris nisi ut aliquip ex ea commodo 
consequat. Duis aute irure dolor in 
reprehenderit in voluptate velit esse 
cillum dolore eu fugiat nulla pariatur. 
Excepteur sint occaecat cupidatat non 
proident, sunt in culpa qui officia 
deserunt mollit anim id est laborum. Nam 
liber te conscient to factor tum poen 
legum odioque civiuda. 




Figure 8.4 - Disposition des objets de l’application 
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Double-cliquez tour à tour sur les différents contrôles et insérez le texte spécifié dans 
le tableau suivant : 


Contrôle 

Texte 

Premier Label 

Saurez- vous trouver le nombre de quatre chiffres que j’ai 
choisi ? 

Deuxième Label 

Tentez votre chance 

Text View 


Round Rect 

But ton 

Choisir un autre nombre 


O 

© 


Pour met tre fin et valider la saisie d'un texte dans un contrôle, appuyez sur 
la touche [ Entrée J du clavier. 


Le texte saisi dans le premier Label est trop long. Comment l'afficher sur 
deux lignes? 


Si nécessaire, cliquez sur l’icône Show the Attributes inspector dans la partie su- 
périeure du volet gauche. Si vous cliquez sur le Label, ses caractéristiques apparaissent 
dans le volet de l’inspecteur, comme sur la figure 8.5. Sélectionnez Word Wrap dans la 
liste déroulante Line Breaks, tapez 2 dans la zone de texte Lines et redimensionnez 
le contrôle pour obtenir l’effet recherché. 


hL 

i- & 


d m 


Text Saurez-vous trouver le 
nombre de quatre chiffres 
que j'ai choisi ? 


Lines 

Behavior Enabled 




Baseline ! Align Centers 


Line Breaks ' Word Wrap 


Alignment | s- = 


Font System 17.0 
Minimum Size 


10 |:i 0 Autoshrink 


DUS 


Figure 8.5 - Il faut afficher le texte sur deux lignes 

Pour supprimer le texte proposé par défaut dans le contrôle TextView, cliquez dessus 
dans Interface Builder, sélectio nnez le texte dans l a zone Te xt du volet de l’inspecteur, 
appuyez sur la touche [ ^Suppr J , puis sur la touche ( Entrée ) du clavier. 

8.6 
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» 


Saurez-vous trouver le nombre de 
quatre chiffres que j'ai choisi ? 


Tentez votre chance 

Lorem Ipsum dolor sit er élit lamet, 
consectetaur cillium adiplsicing pecu, sed 
do eiusmod tempor incididunt ut labore et 
dolore magna aliqua. Ut enim ad minim 
veniam, quis nostrud exercitation ullamco 
laboris nisi ut aiiquip ex ea commodo 
consequat. Duis aute irure dolor In 
reprehenderlt in voluptate veut esse 
cillum dolore eu fugiat nulla pariatur. 
Excepteur sint occaecat cupldatat non 
proldent. sunt in culpa qui officia 
deserunt mollit anim Id est laborum. Nam 
liber te conscient to factor tum poen 
legum odioque civiuda. 



O « 


Text Lorem ipsum dolor sit er 
élit lamet, consectetaur 
cillium adipisicing pecu. 
sed do eiusmod tempor 
incididunt ut labore et 
dolore magna aliqua. Ut 
enim ad minim veniam, 
quis nostrud exercitation 
ullamco laboris nisi ut 
aiiquip ex ea commodo 
consequat. Duis aute irure 
dolor in reprehenderit in 
voluptate velit esse cillum 
dolore eu fugiat nulla 
pariatur. Excepteur sint 
occaecat cupidatat non 
proident. sunt in culpa qui 
officia deserunt mollit 
anim id est laborum. Nam 
liber te conscient to factor 
tum poen legum odioque 
rivuiria 


D U 




Obiecis 


□ il® 


Text 



Figure 8.6 - Suppression du texte par défaut 
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Pour faciliter la saisie dans le Text Field, vous pouvez demander l'affi- 
chage d'un clavier numérique : cliquez sur l'icône Show the Attributes 
inspector dans la barre d'outils et affectez la valeur Numbers and 
Punctuation au paramètre Keyboard, comme indiqué à la figure 8.7. Ainsi, 
le clavier affiché pour la saisie ne contiendra que des chiffres et des signes. 


T Texl Field 

Text [Text 

Placeholder " Placeholder Text 


Background [ Background Image 

’J 

Disabled I Disabled Background lm^ ▼ 1 

Alignment ( = = 

s 

1 

Border Style ( O □ 1 

O 1 


Clear Button | Never appears î | 

|_J Clear when editing begins 

Text Color | MÊM Default î ) 




Font System 14.0 


Min Font Size ' 

» 

3 

0 Adjust to Fit 



Capitalization | None 

) 

Correction | Default 

1 

► Keyboard Numbers and Punctua... 

1 

Appearance | Default 

1 

Return Key | Default 

J 


(_! Auto-enable Return Key 
CD Secure 

T Control 

Alignment [Q| fl] Ej i E3 ) 
Horizontal 

I n ■ b ■ n IT) 


Figure 8.7 - Pour afficher un clavier numérique 


Liaison des contrôles au code 


Cachez la zone d’utilitaires en cliquant sur l’icône Hide or show the Utilities (1) 
et affichez le code ViewController .h en cliquant sur l’icône Show the Assistant 
editor (2), comme montré à la figure 8.8. 



Si la zone de navigation prend trop de place sur le côté gauche de la fenêtre, 
vous pouvez la cacher en cliquant sur l'icône Hide or show the Navigator 
(dans la partie droite de la barre d'outils, au-dessus du libellé View). 


Vous allez maintenant relier les contrôles de l’interface au code. 

Contrôle-glissez-déposez tour à tour les contrôles Text Field et Text View de l’in- 
terface jusqu’au volet de code. Donnez le nom saisie au Text Field, et le nom 
résultats au Text View. 
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Saurez-vous trouver le nombre de 
quatre chiffres que j'ai choisi ? 


Tentez votre chance 


Choisir un autre nombre 


Created by Michel Martir 


laport «UIKit/UIKit 


Figure 8.8 - Il est temps d’afficher le code de l’application 


Si vous avez suivi mes indications, le fichier ViewController .h doit maintenant res- 
sembler à ceci : 

1 # import <UIKit/UIKit.h> 

2 

3 ©interface ViewController : UlViewController 

4 ©property (weak , nonatomic) IBOutlet UITextField ^saisie ; 

5 ©property (weak, nonatomic) IBOutlet UITextView ^résultats; 

6 

7 ©end 

Pour terminer les liaisons, vous devez définir une action pour le contrôle Round Rect 
Button. Contrôle-glissez-déposez ce contrôle juste avant l’instruction Oend. Au relâ- 
chement du bouton gauche de la souris, sélectionnez Action dans la zone Connection, 
tapez autrenombre dans la zone de texte Name et cliquez sur Connect (figure 8.9). 


Connection 

Action 0 

Object ^ View Controller 

Name 

autrenombre 

Type 

,d 

Event 

Touch Up Inside î 

Arguments 

Sender 



Figure 8.9 - Définition d’une action pour le contrôle Round Rect Button 
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La ligne suivante est ajoutée au code : 

l| - ( IBAction) autrenombre : ( id) sender ; 

Sauvegardez votre projet avec la commande Save dans le menu File. Juste histoire de 
souffler un peu, vous pouvez cliquer sur l’icône Run dans la barre d’outils et savourer 
votre travail. Le résultat affiché devrait être semblable à la figure 8.10. 



Saurez-vous trouver le nombre de 
quatre chiffres que j'ai choisi ? 

Tentez votre chance 


Choisir un autre nombre 



Figure 8.10 - Voici à quoi ressemble l’application pour le moment 


Cliquez sur Stop pour revenir à la dure réalité : vous devez maintenant écrire le code 
qui donnera vie à l’application ! 

Avant de commencer, cliquez sur ViewController .h dans le volet de navigation et 
définissez la variable d’instance nombreChoisi de type int pour mémoriser le nombre 
choisi par le device. Le fichier d’en-têtes doit maintenant ressembler à ceci : 


î 

2 

3 

4 

5 

6 
7 


^interface ViewController : UlViewController 

{ 

int nombreChoisi; 

} 

Sproperty (weak , nonatomic) IBOutlet UITextField ^saisie ; 
Sproperty (weak, nonatomic) IBOutlet UITextView ♦résultats; 


9 

10 


- (IBAction) autrenombre : (id) sender ; 
@end 
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Je vous sens vraiment impatients de faire fonctionner l’application. Alors, passons sans 
plus attendre à l’écriture du code. 


Écriture du code 


Si nécessaire, affichez la zone de navigation en cliquant sur l’icône Hide or show the 
Navigator, dans la partie droite de la barre d’outils, au-dessus du libellé View. Cli- 
quez sur mastermindViewController .m dans la zone de navigation. Le code généré 
par Xcode est de taille respectable. Il contient les différentes méthodes utilisées par 
l’application : 


1 //Pour une meilleure lisibilité, j'ai supprimé les commentaires 

ajoutés automatiquement au début du fichier par Xcode 

2 

3 #import " ViewC ont r oller . h" 

4 

5 Oimplementation ViewController 

6 Ssynthesize saisie; 

7 Ssynthesize résultats; 


9 

10 

11 

12 

13 

14 

15 

16 

17 

18 

19 

20 

21 

22 

23 

24 

25 

26 

27 

28 

29 

30 

31 

32 

33 

34 

35 

36 


- ( vo id ) di dRe cei veMemory Warning 

{ 

[super didReceiveMemoryWarning] ; 

// Release any cached data, images, etc that aren ' t in use. 

} 

#pragma mark - View lifecycle 

- ( void ) viewDidLoad 

{ 

[super viewDidLoad]; 

// Do any additional setup after loading the view, typically 
f r om a nib . 

} 

- ( vo id ) viewDidUnload 

{ 

[self setSaisie : nil] ; 

[self setResultats : nil] ; 

[super viewDidUnload]; 

// Release any retained subviews of the main view . 

// e.g. self . myOutlet = nil; 

} 

- (void)viewWillAppear:(B00L) an i mat ed 

{ 

[super viewWillAppear : animated] ; 

} 
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37 

38 

39 

40 

41 

42 

43 

44 

45 

46 

47 

48 

49 

50 

51 

52 

53 

54 

55 

56 

57 

58 

59 

60 


- (void) viewDidAppear : (B00L) animated 

{ 

[super viewDidAppear : animated] ; 

} 

- (void) viewWillDisappear : (B00L) animated 

{ 

[super viewWillDisappear : animated] ; 

} 

- (void) viewDidDisappear : (B00L) animated 

{ 

[super viewDidDisappear : animated] ; 

} 

- (B00L) shouldAutorotateTo Interface Orientât ion : ( 

UlInterfaceOrientation) interf aceOrientation 

{ 

// Return YES for supported orientations 
return ( int erf ace Or ient at ion ! = 

UIInterfaceOrientationPortraitUpsideDown) ; 

} 

- ( IBAction) autrenombre : ( id) sender { 

} 

®end 


En examinant les dernières lignes, vous reconnaissez certainement la partie déclarative 
liée à l’action sur le contrôle Round Rect Button : 

1 - ( IBAction) autrenombre :( id) sender { 

2 } 

Quelques lignes plus haut, la méthode viewDidLoad va vous permettre d’initialiser 
l’application : 

1 - (void) viewDidLoad 

2 { 

3 [super viewDidLoad]; 

4 // Do any additional setup after loading the view, typically 

f rom a nib . 

5 } 

Mais pourquoi serait-il nécessaire d’initialiser l’application me direz- vous ? Eh bien. . . 
pour choisir le nombre à découvrir ! 


Tirage aléatoire du nombre à découvrir 

Ajoutez la ligne que nous avons vue plus haut, après [super viewDidLoad] ; : 

1 I nombreChoisi = arc4random() '/, 9000 + 1000; 
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L’application sait maintenant tirer au hasard un nombre compris entre 1000 et 9999. 


Traitement suite à la proposition d’un nombre 


Lorsque le joueur a saisi un nombre de quatre chiffres, il appuie sur la touche Return 
pour valider la saisie. Le clavier doit alors disparaître de l’écran et le nombre entré 
doit être comparé au nombre à découvrir. Pour ce faire, il est nécessaire de capturer 
l’événement « appui sur la touche Return » et de le relier à une méthode afin d’effectuer 
les traitements nécessaires. Dans un premier temps, commencez par définir la méthode 
saisieReturn dans le fichier d’en-têtes. Cliquez sur ViewController .h dans le volet 
de navigation et entrez cette ligne, juste au-dessus du @end final : 

1 - ( IBAction) saisieReturn : (id) sender ; 


Le fichier d’en-têtes doit maintenant ressembler à ceci : 


î 

2 

3 

4 

5 

6 

7 

8 
9 

10 

11 

12 

13 


# import CUIKit/UIKit .h> 

©interface ViewController : UlViewController 

{ 

int nombreChoisi ; 

} 

©property (weak , nonatomic) IBOutlet UITextField ♦saisie; 
©property (weak, nonatomic) IBOutlet UITextView ♦résultats; 

- (IBAction) aut renombre : (id) sender ; 

- ( IBAction) saisieReturn : (id) sender ; 

©end 


Pour écrire le code qui efface le clavier de l’écran, cliquez sur ViewController .m dans 
le volet de navigation et définissez la méthode saisieReturn comme suit : 

1 -(IBAction) saisieReturn : (id) sender 

2 { 

3 [sender resignFirstResponder ] ; 

4 } 

La méthode resignFirstResponder efface le clavier. C’est aussi simple que cela! 

N’essayez pas d’exécuter l’application : vous devez auparavant relier l’événement « ap- 
pui sur la touche Retour » à la méthode saisieReturn. 

Pour cela, sélectionnez l’entrée MainStoryboard. storyboard dans la zone de navi- 
gation, affichez le volet des utilitaires en cliquant sur Hide or show the Utilities 
dans la barre d’outils, puis cliquez sur Show the Connections inspector, dans la 
partie supérieure. Cliquez sur le contrôle Text Field dans la zone d’édition pour le 
sélectionner. Sous Sent Events, repérez le rond à droite de l’événement Did End On 
Exit et déplacez-le sur l’icône View Controller, dans la partie inférieure de la zone 
d’édition. Au relâchement du bouton gauche de la souris, deux choix vous sont pro- 
posés : autreNombre et saisieReturn (figure 8.11). Cliquez sur saisieReturn. Ainsi, 
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la méthode saisieReturn sera exécutée lorsque l’utilisateur appuiera sur la touche 
Return du téléphone. 



Figure 8.11 - Deux choix sont proposés : autreNombre et saisieReturn 

Vous pouvez maintenant exécuter l’application et vérifier que l’appui sur la touche 
Return dissimule le clavier. 

Il est temps maintenant d’écrire le code relatif au traitement du nombre choisi par 
le joueur. Cliquez sur ViewController .m dans la zone de navigation et complétez la 
méthode saisieReturn comme suit : 

1 -(IBAction) saisieReturn: (id) sender 

2 { 

3 [sender res ignFir s tResponder ] ; 

4 int bienPlace = 0; 

5 int charlndex ; //Index de boucle pour parcourir tous les 

caractères des chaînes à comparer 

6 unichar testCharl , testChar2; //Les caractères à comparer : 

testCharl dans le nombre proposé, testChar2 dans le nombre 
à trouver 

7 for (charlndex = 0; charlndex < 4; charlndex++) 

8 { 

9 testCharl = [saisie. text characterAtlndex : charlndex] ; 
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10 

11 

12 

13 

14 


15 

16 

17 


testChar2 = [[NSString s t r ingWit hFormat : 0 "7,d" , nombreChoisi 
] characterAt Index : charlndex] ; 
if (testCharl == testChar2) 
bienP lace ++ ; 

} 

résultat s . text = [NSString stringWithFormat : @ "’/,<§’/,<§'/, d'/, <§’/,<§" , 
saisie, text, @ " : Bien placés : ", bienPlace , ®"\r", 

résultats .text] ; 

if (bienPlace == 4) 

résultats . text = [NSString stringWithFormat : @ d" , @ " 
Bravo, le résultat était ", nombreChoisi]; 


Examinons un peu ce code ensemble. 

Comme il a été dit précédemment, la ligne 3 supprime le clavier de l’écran. Jusque-là, 
tout va bien ! 

Le bloc d’instructions suivant (lignes 4 à 13) compare le nombre entré par le joueur au 
nombre à découvrir. Les premières lignes déclarent plusieurs variables : 

- la variable entière bienPlace est définie et initialisée à 0 : int bienPlace = 0; 

- la variable entière charlndex est définie mais non initialisée : int charlndex; 

- il en va de même pour les variables unichar testCharl et testChar2 : unichar 
testCharl, testChar2; 

La comparaison des quatre chiffres se fait dans une boucle for, en utilisant la variable 
charlndex comme index de boucle : 

1 | for (charlndex = 0; charlndex < 4; charlndex + + ) 

À l’intérieur de la boucle, la première instruction s’intéresse à la saisie du joueur. Elle 
isole le caractère d’index charlndex et le stocke dans la variable unichar testCharl : 

l| testCharl = [saisie. text characterAtlndex : charlndex] ; 

La deuxième instruction fait de même, mais sur le nombre tiré aléatoirement. L’ins- 
truction est plus complexe, car le nombre choisi aléatoirement est un int et non un 
NSString. Il est donc nécessaire de le convertir en NSString avant de procéder à l’ex- 
traction : 

I testChar2 = [[NSString stringWithFormat : 0 "’/,d" , nombreChoisi] 

characterAtlndex : charlndex] ; 

Le premier message convertit l’int nombreChoisi en un NSString : 
l| [NSString stringWithFormat "*/,d" , nombreChoisi] 

On extrait de l’objet ainsi obtenu le caractère qui se trouve à l’emplacement charlndex 
(characterAtlndex : charlndex) et on mémorise ce caractère dans la variable testChar2 
(testChar2 =). 

II ne reste plus qu’à comparer testCharl à testChar2 et à incrémenter la variable 
bienPlace si ces deux variables sont égales : 
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1 if (testCharl == testChar2) 

2 bienPlace++; 

Une fois que les quatre chiffres ont été testés, il faut afficher le résultat dans le contrôle 
TextView. C’est le rôle de l’instruction suivante : 

1 résultats . text = [NSString s tringWithFormat : @ "’/,<§’/,<§'/, d*/, <§'/,<§" , 
saisie. text, 0" : Bien placés : ", bienPlace , 0"\r", 

résultats . text] ; 

On utilise pour cela une chaîne formatée ( [NSString stringWithFormat : Exa- 

minons le format de la chaîne affichée : 

î | 

En comptant le nombre de vous pouvez facilement déduire que cette chaîne est 
composée de cinq éléments. De gauche à droite, deux chaînes ('/,(§), un nombre décimal 
(“/.d) et deux chaînes (%@). Ces éléments sont les suivants : 

- la valeur saisie par le joueur, saisie. text ; 

- le texte « Bien placés : » ; 

- la valeur décimale bienPlace, convertie en une chaîne de caractères ; 

- un saut de ligne \r ; 

- les différentes informations précédemment affichées dans le contrôle TextView. 

La dernière instruction teste si la partie est terminée : 

1 if (bienPlace == 4) 

2 résultats . text = [NSString stringWithFormat : @ d" , ®"Bravo , 

le résultat était ", nombreChois i ] ; 

Si le nombre de caractères bien placés est égal à 4 (if (bienPlace == 4) ), cela signifie 
que le nombre entré est égal au nombre à découvrir. Dans ce cas, un message est affiché 
dans le contrôle TextView résultats (résultats . text =). Ici encore, nous utilisons 
une chaîne formatée ([NSString stringWithFormat: ...]). Comme vous pouvez le 
voir, le texte affiché est composé d’une chaîne et d’un nombre entier : le texte « Bravo, 
le résultat était », suivi du nombre à découvrir. 


Tirage aléatoire d’un autre nombre 

Pour terminer ce programme, il reste à écrire le code relatif à l’appui sur le bouton 
Choisir un autre nombre. Rassurez- vous, cette tâche vous paraîtra on ne peut plus 
simple après ce que vous venez de vivre ! L’entrée ViewController . m étant sélectionnée 
dans le volet de navigation, déplacez- vous dans la partie inférieure du code et complétez 
la méthode autrenombre comme suit : 

1 - ( IBAction) autrenombre :( id) sender 

2 { 

3 nombreChoisi = arc4random() ’/, 9000 + 1000; 

4 résultats . text = [NSString s tringWithFormat : @ , @"J’ai 

choisi un nouveau nombre\r"]; 

5 } 
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La première instruction est identique à celle qui a déjà été utilisée pour tirer un nombre 
aléatoire. Elle choisit un nombre compris entre 1000 et 9999 et le stocke dans la com- 
posante text de l’objet label nombreChoisi : 

1 | nombreChoisi = arc4random() '/, 9000 + 1000 ; 

La deuxième instruction affiche le message « J’ai choisi un nouveau nombre » dans le 
contrôle TextView : 

1 résultat s . text = [NSString stringWithFormat :®"V/,8" , 0 " J ' ai 
choisi un nouveau nombre \ textbacks lash {}r "] ; 

L’application est entièrement fonctionnelle. Cliquez sur Run et amusez-vous bien ! 


Le code complet 

Je vous mets ici le code complet de l’application, que vous pouvez copier grâce au code 
web suivant. 

> 


Copier le code 
Code web : 503914 


ViewController.h 


1 

2 

3 

4 

5 

6 

7 

8 
9 

10 

11 

12 

13 


# import CUIKit/UIKit .h> 

©interface ViewCont r oller : UlViewController 

{ 

int nombreChoisi; 

} 

©property (weak, nonatomic) IBOutlet UITextField ^saisie ; 
©property (weak, nonatomic) IBOutlet UITextView ♦résultats; 

- (IBAction) aut renombre : (id) sender ; 

- ( IBAction) saisieReturn : (id) sender ; 

©end 


ViewController.m 


1 #import "ViewController.h" 

2 

3 ©implémentation ViewController 

4 ©synthesize saisie; 

5 ©synthesize résultats; 

6 

7 - ( vo id ) di dRe cei veMemory Warning 

8 { 

9 [super didReceiveMemoryWarning] ; 
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14 

15 

16 

17 

18 

19 

20 

21 

22 

23 

24 

25 

26 

27 

28 

29 

30 

31 

32 

33 

34 

35 

36 

37 

38 

39 

40 

41 

42 

43 

44 

45 

46 

47 

48 

49 

50 

51 

52 

53 

54 

55 

56 

57 
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/ / Release any cached data, images , etc that aren't in use. 

} 

#pragma mark - View lifecycle 

- ( void) viewDidLoad 

{ 

[super viewDidLoad]; 

nombreChoisi = arc4random() '/, 9000 + 1000; 

} 

- ( void) viewDidUnload 

{ 

[self setSaisie : nil] ; 

[self setResultats : nil] ; 

[super viewDidUnload]; 

// Release any retained subviews of the main view . 

// e.g. self . myOut let = nil; 

} 

- (void) viewWill Appear : (B00L) animated 

{ 

[super viewWillAppear : animated] ; 

} 

- (void) viewDidAppear : (B00L) animated 

{ 

[super viewDidAppear : animated] ; 

} 

- (void) viewWillDis appear : (B00L) animated 

{ 

[super viewWillDisappear : animated] ; 

} 

- (void) viewDidDisappear : (B00L) animated 

{ 

[super viewDidDisappear : animated] ; 

} 

- (B00L) shouldAutorotateTo Interface Orientât ion : ( 

Ullnterf aceOrientation) interf aceOrientation 

{ 

// Return YES for supported orientations 
return ( int erf ace Or ient at ion ! = 

UIInterfaceOrientationPortraitUpsideDown) ; 

} 


- (IBAction) autrenombre : (id) sender 


{ 
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nombreChoisi = arc4random() / 9000 + 1000; 

résultat s . text = [NSString s t r ingWit hFormat : @ " '/, @ " , @"J'ai 
choisi un nouveau nombre\r"]; 


-(IBAction) saisieReturn : (id) sender 

{ 

[sender resignFirstResponder ] ; 
int bienPlace = 0; 
int charlndex ; 

unichar testCharl , testChar2 ; 

for (charlndex = 0; charlndex < 4; charlndex++) 

{ 

testCharl = [saisie. text characterAtlndex : charlndex] ; 
testChar2 = [[NSString stringWithFormat : @ "*/,d" , nombreChoisi 
] characterAtlndex : charlndex] ; 
if (testCharl == testChar2) 
bienPlace ++ ; 

} 

résultat s . text = [NSString stringWithFormat : @ "*/,<§'/, @ */, d */, @ */, @ " , 
saisie. text, : Bien placés : ", bienPlace, 0"\r", 

résultats .text] ; 
if (bienPlace == 4) 

résultats . text = [NSString stringWithFormat : @ d" , @ " 
Bravo, le résultat était ", nombreChoisi]; 

} 

®end 
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Troisième partie 

Création d’interfaces graphiques 
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Chapitre 



Fenêtres, vues et contrôles 


Difficulté : — 

L es iPhone, iPad et iPod Touch ont une particularité : ils ne sont capables d'afficher 
qu'une seule fenêtre sur l'écran. Ceci les différencie des ordinateurs, sur lesquels un 
nombre indéfini de fenêtres peut être affiché. 

Pour que cette spécificité ne soit pas une limitation, les devices iOS peuvent afficher plu- 
sieurs vues et les « empiler » selon les directives du programmeur. 

Une vue est constituée d'un ou de plusieurs contrôles. Il peut s'agir d'informations (textes, 
images, vidéos), d'éléments pour communiquer avec l'utilisateur (boutons, zones de texte, 
curseurs, etc.) ou encore d'éléments pour basculer entre les différentes vues (onglets, barres 
de navigation, barres de recherche, etc.). 
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Création d’une application multivues 

Avant de nous intéresser aux contrôles, nous allons consacrer un peu de temps à l’étude 
des vues. Cette étape est fondamentale. En effet, si les applications les plus simples 
comportent une seule vue, il n’est pas rare d’utiliser trois ou quatre vues dans une 
application traditionnelle. 

Une bonne nouvelle : la quasi-totalité du travail se fera dans Interface Builder. Ce sera 
donc un jeu d’enfant pour vous. 


Création de l’application 

Commencez par créer une application basée sur le modèle Single View Application 
et donnez-lui le nom « troisVues ». Cliquez sur MainStoryboard. storyboard dans le 
volet de navigation. 

Rappelons que nous voulons créer une application qui comporte trois vues. Un contrô- 
leur de vue étant déjà présent dans l’application, vous allez en ajouter deux autres en 
effectuant des glisser-déposer de la bibliothèque d’objets à la zone d’édition d’interface 
Builder. Cliquez sur l’icône Hide or show the Utilities dans la barre d’outils de 
Xcode (1), sur l’icône Show the Object library dans la partie inférieure du volet 
des utilitaires (2), puis faites glisser deux View Controller sur la zone d’édition (3), 
comme indiqué à la figure 9.1. 



Figure 9.1 - Il faut ajouter deux vues à l’application 

Pour bien repérer chacune des vues, vous allez modifier leur couleur d’arrière-plan. 
Cliquez sur l’icône Show the Attributes inspector dans le volet des utilitaires et 
agissez sur la liste déroulante Background. Choisissez alors les couleurs que vous sou- 
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haitez. Pour ma part, j’ai respectivement choisi les couleurs bleu, blanc et vert. 
Ensuite, faites glisser : 

- un contrôle Label sur chacune des vues ; 

- un contrôle Round Rect Button sur la première vue et un autre sur la troisième 
vue ; 

- deux contrôles Round Rect Button sur la deuxième vue. 

Double-cliquez tour à tour sur chacun de ces contrôles et ajoutez le texte suivant : 


Vue 

Contrôle 

Texte 

1 

Label 

Vue 1 

1 

Round Rect Button 

Vue suivante 

2 

Label 

Vue 2 

2 

Premier Round Rect Button 

Vue suivante 

2 

Deuxième Round Rect Button 

Vue précédente 

3 

Label 

Vue 3 

3 

Round Rect Button 

Vue précédente 


La figure 9.2 représente le résultat que j’ai obtenu. 



Figure 9.2 - Les trois vues avec les Label et les Round Rect Button 

Pour que ces vues puissent se faire référence l’une l’autre, vous allez ajouter un contrô- 
leur de navigation. 

Cliquez sur la première vue, déroulez le menu Editor, pointez Embed In et cliquez sur 
Navigation Controller. Un contrôleur de navigation est ajouté (figure 9.3), et il est 
automatiquement relié à la première vue. 

Vous allez maintenant relier les Round Rect Button aux différentes vues. Je vais vous 
indiquer en détail comment procéder pour relier le bouton de la vue 1 à la vue 2. Vous 
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Figure 9.3 - Le contrôleur est automatiquement relié à la vue sélectionnée 


ferez de même pour relier les autres boutons des autres vues. 

Clique z sur le Round Rect Button de la vue 1 pour le sélectionner. Maintenez la touche 
( Ctrl ) enfoncée, puis glissez-déposez le Round Rect Button sur la vue 2. Au relâche- 
ment du bouton gauche, une bulle intitulée Storyboard Segues est affichée. Dans cette 
bulle, vous devez choisir le type de transition entre les deux vues : 

- Push : transition horizontale ; 

- Modal : transition verticale ; 

- Custom : transition personnalisée. 

Choisissez Push pour obtenir une translation horizontale. Une flèche entre la vue 1 et 
la vue 2 indique que la liaison a été établie (figure 9.4). 

I"" - H 



Figure 9.4 - Une flèche indique que la liaison a été faite 

Recommencez la manipulation qui vient d’être décrite pour relier : 

- les vues 1 et 2 via le bouton Vue précédente de la vue 2 ; 

- les vues 2 et 3 via le bouton Vue suivante de la vue 2 ; 

- les vues 2 et 3 via le bouton Vue précédente de la vue 3. 

Ça y est, vous pouvez exécuter l’application et jouer avec les boutons des trois vues. 
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Insérer un contrôle dans une application 

Arrivés à ce point, vous savez créer une application multivues, mais vous ne savez pas 
encore (du moins pas précisément) comment ajouter du contenu dans chacune de ces 
vues. Il est grand temps de nous intéresser aux contrôles. 

Pour insérer un contrôle dans une application, vous devez dans un premier temps 
afficher la bibliothèque de contrôles. Comme à la figure 9.5, sélectionnez le fichier 
MainStoryboard. storyboard correspondant à la vue dans la zone de navigation (1), 
cliquez sur l’icône Hide or show the Utilities dans la barre d’outils (2), puis sur 
Show the Object Library dans la zone des utilitaires (3). Pointez alors un contrôle 
dans la bibliothèque, maintenez le bouton gauche de la souris enfoncé et déposez le 
contrôle sur la fenêtre de l’application (4). 



Figure 9.5 - Insertion d’un contrôle dans une application 


Pour insérer un contrôle dans l'application, vous pouvez également double- 
cliquer sur son icône dans la bibliothèque. 

Si vous n’êtes pas certains de la fonction d’un contrôle, cliquez dessus dans la biblio- 
thèque et maintenez le pointeur de la souris immobile pendant quelques instants. Une 
bulle d’aide sera alors affichée. Si ces informations ne sont pas suffisantes, vous pouvez 
cliquer sur l’icône Show Quick Help dans la partie supérieure du volet des utilitaires, 
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comme indiqué à la figure 9.6. 


d/e 

Jb ••• <& o 

▼ Quick Hcttf 

✓ 


Name: ülStepper 
Availability: iOS (5.0 and later) 

Abstract: A stepper control provides a user 
interface for incrementing or decrementing a 
value. 

Declared In: UlStepper.h 
Reference: ÜlStepper Class Reference 


D U 


Figure 9.6 - Cliquez sur l’icône Show Quick Help 

Si nécessaire, cliquez sur un des liens (affichés en bleu) pour accéder à l’aide correspon- 
dante dans la documentation Apple. 

Positionner, aligner et redimensionner un contrôle à 
vue 

La façon la plus naturelle et la plus rapide pour positionner, aligner et redimensionner 
des contrôles consiste à utiliser la souris. 


Positionner un contrôle à vue 

Pour déplacer un contrôle dans la vue qui le contient, pointez-le, maintenez le bouton 
gauche de la souris enfoncé, déplacez la souris jusqu’à ce que l’objet ait la position 
souhaitée puis relâchez le bouton gauche de la souris. 


Aligner un contrôle à vue 

Les contrôles d’une application peuvent être alignés à vue. Ainsi par exemple, il est pos- 
sible de faire correspondre le bord gauche d’un contrôle avec celui d’un autre contrôle, 
ou encore d’aligner un contrôle au centre ou sur une marge de la vue. Pointez le contrôle 
à positionner, maintenez le bouton gauche de la souris enfoncé et déplacez le contrôle 
dans la vue. Une ou plusieurs lignes pointillées signalent le ou les divers alignements 
possibles pendant que le contrôle est déplacé, comme le montre la figure 9.7. Relâchez 
le bouton gauche lorsque le contrôle a la position souhaitée. 
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» 


Lorem ipsum dolor sit er élit lamet, 
consectetaur cillium adipisicing pecu, 
sed do eiusmod tempor incididunt ut 
labore et dolore magna aliqua. Ut 
enim ad minim veniam, quis nostrud 
exercitation ullamco laboris nisi ut 
aliquip ex ea commodo consequat. 
Duis aute irure dolor in reprehenderit 
in voluptate velit esse cillum dolore eu 
fugiat nulla pariatur. Excepteur sint 
occaecat cupidatat non proident, sunt 
in culpa qui officia deserunt mollit 
anim id est laborum. Nam liber te 


Figure 9.7 - Des pointillés apparaissent pour aligner les différents éléments 


Redimensionner un contrôle à vue 

De nombreux contrôles peuvent être redimensionnés. Pour cela, il suffit d’agir sur leurs 
poignées de redimensionnement à l’aide de la souris. Cliquez sur le contrôle pour le sélec- 
tionner. Plusieurs poignées de redimensionnement sont affichées. Pointez l’une d’entre 
elles. Lorsque le pointeur de la souris change de forme, maintenez le bouton gauche 
enfoncé et déplacez la souris pour obtenir la dimension souhaitée (figure 9.8). 


Le pointeur est positionné 
pour un redimensionnement 


<y a o 

o + 

Ù- O- O 



o 


Poignées de redimensionnement 


Figure 9.8 - Il est facile de redimensionner à la main un élément 
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Un aperçu des contrôles disponibles 


Vous trouverez dans cette section les différents contrôles accessibles dans la biblio- 
thèque. Chacun d’eux peut être utilisé dans une application pour iPhone, iPod Touch 
et iPad. 


Label Label : Texte non modifiable par l’utilisateur 


Round Rect Button : Bouton de commande touch 


Segmented Control : Onglets permettant d’afficher différentes vues / 
contrôles 


Text Text Field : Zone de texte modifiable par l’utilisateur 


Slider : Curseur pour faciliter la saisie d’une valeur 


c Switch : Bouton de type ON/OFF 


Activity Indicator View : Indicateur d’activité pour faire patienter l’uti- 
lisateur pendant un long traitement 


Progress View : Indicateur de progression utilisé pendant un long traite- 
ment 



Page Control : Indique la page en cours de visualisation (dans une appli- 
cation multipage) 


Table View : Liste hiérarchique d’informations textuelles disposées vertica- 
lement 
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Table View Cell : Paramètre d’une des cellules affichées dans un Table 
View 



Image View : Conteneur permettant d’afficher une image ou une animation 



Text View : Zone de texte multiligne éditable 



Web View : Affichage d’un contenu Web 



Map View : Affichage d’une carte, similaire à celle affichée dans l’application 
Plans 


Scroll View : Contrôle permettant d’afficher un contenu d’une taille supé- 
rieure à celle de la fenêtre / du contrôle en faisant glisser l’affichage dans la 
zone de visualisation 



Date Picker : Sélection d’une date et d’une heure à l’aide de plusieurs 
contrôles en forme de roues 


Picker View : Sélection d’une valeur dans un contrôle en forme de roue 



Ad BannerView : Vue dédiée à l’affichage de publicités 


GLKit View : Vue OpenGL ES 



Tap Gesture Recognizer : Reconnaissance d’une gestuelle multitouch 



Pinch Gesture Recognizer : Reconnaissance de la gestuelle « rétrécir » 
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Rotation Gesture Recognizer : Reconnaissance de la gestuelle « rota- 
tion » 


Swipe Gesture Recognizer : Reconnaissance de la gestuelle « glisser » 



Pan Gesture Recognizer : Reconnaissance de la gestuelle « glisser » 



Long Press Gesture Recognizer : Reconnaissance de la gestuelle « long 
toucher » 


• Object : Un objet non disponible dans Interface Builder, tiré d’une ins- 
tance d’une classe 


O 

O 

Q 


View Controller : Contrôle dédié à la gestion de barres d’outils, barres de 
navigation et vues d’une application 


Table View Controller : Contrôle dédié à la gestion d’un Table View 


Navigation Controller : Ce contrôle est dédié à la gestion des contrôleurs 
de vue. Il fournit des informations relatives à la vue active. 


Tab Bar Controller : Gère plusieurs vues au travers d’onglets 


View : Zone rectangulaire de tracé 


a Navigation Bar : Barre de navigation, affichée juste en dessous de la barre 

d’état 


Navigation Item : Élément affiché dans un contrôle Navigation Bar 
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Search Bar : Barre de recherche éditable 



Search Bar and Search Display Controller : Barre de recherche et son 
contrôleur Table View associé 


Toolbar : Barre d’outils contenant un ou plusieurs boutons 

IB i 


I j Bar Button Item : Un bouton dans un contrôle Toolbar 


Fixed Space Bar Button Item : Espace ajustable par le programmeur 
dans un contrôle Toolbar 


Flexible Space Bar Button Item : Espace qui s’ajuste automatiquement 
en fonction de la place disponible dans un contrôle Toolbar 



Tab Bar : Barre d’onglets 



Tab Bar Item : Une icône représentant un onglet dans un contrôle Tab Bar 


Les volets Attributs et Taille 


Tous ces contrôles ont l'air très intéressants, mais est-il possible de les per- 
sonnaliser ? 

cette (longue) liste, vous avez vu qu’il était possible de changer la taille 
d’un contrôle en agissant sur ses poignées de redimensionnement. Rassurez-vous, la 
personnalisation des contrôles ne se limite pas à leur redimensionnement. De nombreux 
autres paramètres sont accessibles en utilisant le volet des attributs. Pour accéder à ce 
volet, cliquez sur l’icône Show the Attributes inspector, dans la partie supérieure 
du volet des utilitaires, comme indiqué à la figure 9.9. 

Je ne vais pas décrire en détail tous les paramètres accessibles dans le volet des attributs, 


e 

Juste avant 
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D B S ( 



Type Rounded Rect 


State Config | Default 

Title Default Title 
Image I Default Image 
Background Default Background Image 

Font System Bold 15.0 
Text Color | i i Default 
Shadow Color | i ,.i Default 


Z3 


Shadow Offset 


Z0 


Width 

O Reverses On Highlight 


Height 


Highlight Tint 
Drawing 


Q Shows Touch On Highlight 
Highlighted Adjusts Image 
Disabled Adjusts Image 
| Truncate Middle 


D0 


Edge ! 
Inset 


Top 


j >]0 1 


ZD 

Z0 


Figure 9.9 - Affichage du volet des attributs 


d’autant plus qu’ils varient énormément d’un contrôle à l’autre. Ce sera donc à vous 
de les découvrir. Cependant, je ne peux m’empêcher de vous donner quelques conseils 
pour que vous soyez encore plus efficaces. 

- Le volet des attributs concerne le contrôle actif. Pour sélectionner un contrôle, il vous 
suffit de cliquer dessus. 

- Les caractéristiques de la vue peuvent également être ajustées dans le volet des 
attributs : il suffit pour cela de cliquer sur un emplacement inoccupé de la vue afin 
d’accéder aux paramètres correspondants. 

- Pour sélectionner facilement un des contrôles de l’application, vous pouvez utiliser la 
barre d’accès rapide d’interface Builder (cette barre est située au-dessus de la zone 
d’édition). Cliquez sur l’icône View puis sur le contrôle que vous voulez sélectionner. 

- Pour chaque contrôle, le volet des attributs donne accès à un grand nombre de 
caractéristiques. Cependant, les informations relatives à la position et à la taille ne 
sont pas accessibles. Si vous désirez positionner très précisément un contrôle, vous 
utiliserez le volet Taille. Cliquez sur le contrôle concerné, puis sur l’icône Show the 
Size inspector dans la partie supérieure du volet des utilitaires. 


En résumé 

- Les iPhone, iPod Touch et iPad ont une particularité : ils ne sont capables d’afficher 
qu’une et une seule fenêtre sur l’écran. Cependant, il est possible de définir plusieurs 
vues dans Interface Builder, en glissant-déposant des contrôles View Controller 
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depuis la bibliothèque d’objets dans le canevas. 

- Pour que plusieurs vues puissent se faire référence l’une l’autre, vous devez ajouter 
un contrôleur de navigation (Navigation Controller). Ce dernier est ajouté avec 
la commande Embed In/Navigation Controller dans le menu Editor de Xcode. 

- Pour définir une transition d’une vue à une autre, contrôle-glissez-déposez un bouton 
de la vue d’origine sur la vue de destination et choisissez un type de transition : Push, 
Modal ou Custom. 

- Pour ajouter des contrôles dans une application multivue, glissez-déposez le contrôle 
souhaité depuis la bibliothèque de contrôles dans la vue qui doit l’héberger. Les 
contrôles ainsi déposés peuvent être déplacés, alignés et redimensionnés à vue. Vous 
pouvez également utiliser les volets Attributs et Taille pour accéder à des para- 
mètres complémentaires. 

- Pour sélectionner facilement un des contrôles de l’application, vous pouvez utiliser 
la barre d’accès rapide d’interface Builder, au-dessus du canevas. Cliquez sur l’icône 
View puis sur le contrôle que vous voulez sélectionner. 
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Chapitre 



Les contrôles qui affichent des données 

( 1 / 2 ) 


Difficulté : _ 

D ans ce chapitre, nous allons passer en revue les contrôles qui affichent du texte 
et des images sur l'écran. Au fil des pages, vous apprendrez à les ajouter dans une 
application, à les personnaliser via Interface Builder, à les interfacer (c'est-à-dire à les 
rendre accessibles) dans le code Objective-C et à les faire vivre avec du code Objective-C. 

Ce chapitre et le suivant sont très importants car ils donnent les bases de toutes vos futures 
applications. Je vous suggère de les lire une première fois, puis d'y revenir lorsque vous 
développerez vos propres applications. Vous y trouverez de nombreux exemples pratiques 
qu'il vous suffira d'adapter à vos besoins. Cette adaptation ne nécessitera généralement 
que quelques modifications dans le nom des objets utilisés ! 
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Afficher du texte non modifiable 

Les contrôles Label (figure 10.1) sont utilisés pour afficher des textes courts sur une 
ou plusieurs lignes. Leur contenu ne peut pas être modifié par l’utilisateur. Les carac- 
téristiques d’un Label peuvent être définies dans Interface Builder, comme le montre 
la figure 10.2. 


Label 


Figure 10.1 - L’icône du contrôle Label 


▼ Label 

Text 

Label 

1 1 

Lines 

1 

HQ 

Behavior 0 Enabled 

Baseline 

Align Centers 

= 

Line Breaks 

Truncate Tail 

* 

Alignment 

« ■ 

- 

Font 

System 17.0 

mm 

Minimum Size 

10 0 

Autoshrink 


Text Color | 
Highlighted 
Shadow | 
Shadow Offset 


Horizontal Vertical 


ï]Q 


View 


T 


Mode 

Tag 


Left 


30 i 


i Cl User Interaction Enabled 
O Multiple Touch 


Alpha 
Background | 


Drawing Q Opaque 0 Hidden 

0 Clears Graphics Context 


Figure 10.2 - Il est possible de modifier les caractéristiques d’un Label dans Interface 
Builder 

Vous pouvez choisir, entre autres, le texte affiché dans le label, l’alignement du texte 
dans le contrôle, le nombre de lignes, la police et la couleur des caractères. En utilisant 
du code Objective-C, vous pouvez également agir sur le texte, la police, la taille et la 
couleur des caractères ainsi que la couleur d’arrière-plan d’un label. 

1 monLabel . text = @"Un court texte affiché dans le contrôle Label 

sur deux lignes"; 

2 monLabel . numberOf Lines = 2; 

3 monLabel . f ont = [UIFont f ontWithName : @ " Courier " size:10.0f]; 

4 monLabel . text Alignment = UIText AlignmentCenter ; 
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5 monLabel . textColor = [UlColor colorWithRed: 1 . Of green : 0 . Of 

blue : O.Of alpha: l.Of]; 

- La première ligne définit le texte affiché dans le Label. 

- La deuxième ligne indique que le texte sera affiché sur deux lignes. 

- La troisième ligne définit la police et la taille des caractères. 

- La quatrième ligne définit le mode d’alignement du texte dans le contrôle. 

- Enfin, la cinquième ligne définit la couleur du texte via ses composantes rouge 
(colorWithRed), verte (green) et bleue (blue) et sa transparence (alpha). 

Les composantes de couleur sont des nombres flottants compris entre O.Of 
et l.Of. Pour obtenir une des trois couleurs de base (rouge, vert ou bleu), 
initialisez cette couleur à l.Of et les deux autres à O.Of. Dans cet exemple, 
la composante rouge est initialisée à l.Of et les deux autres composantes à 
O.Of. La couleur obtenue est donc un rouge pur. Quant à la transparence, 
il s'agit également d'un nombre flottant compris entre O.Of (transparent) et 
1 . Of (opaque). 

D’autres méthodes sont disponibles pour manipuler les contrôles Label. Pour en avoir 
un aperçu, consultez la documentation relative à la classe UILabel. 

Comment avoir une liste complète des polices disponibles sur un device iOS? 


La liste des polices disponibles sur un device iOS est accessible sur le site Web iOS 
Fonts. 


iOS Fonts 


v Code web : 387967 

J 


Saisir du texte sur une ligne 

Les Text Field (figure 10.3) sont des zones de texte monoligne. Ils sont utilisés pour 
saisir des données textuelles courtes, comme un nom ou un mot de passe par exemple. 
Le texte saisi dans un contrôle Text Field est accessible en lecture et en écriture à 
travers sa propriété text. 




Text 


Figure 10.3 - L’icône du contrôle Text Field 


Supposons que vous ayez défini le Label monLabel et le Text Field monTextField. 
Pour afficher dans le Label le contenu du Text Field chaque fois que ce dernier change, 
procédez comme suit : 
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1. contrôle-glissez-déposez le Label de la fenêtre d’édition dans le code du fichier 
d’en-têtes, juste au-dessus du @end final et créez l’outlet monLabel ; 

2. contrôle-glissez-déposez le Text Field de la fenêtre d’édition dans le code du 
fichier d’en-têtes, juste au-dessus du @end final et créez l’outlet monTextField ; 

3. contrôle-glissez-déposez le Text Field de la fenêtre d’édition dans le code du 
fichier d’en-têtes, juste au-dessus du @end final et créez l’action monTextField, 
de type Editing Changed ; 

4. insérez le code suivant dans la méthode monTextFieldChange : 

1 - ( IBAction) monTextFieldChange :( id) sender { 

2 monLabel . text = monTextField . text ; 

3 } 

Tout comme pour les Label, vous pouvez choisir l’alignement, la police et la couleur du 
texte, dans Interface Builder ou avec du code Objective-C. Pour inviter l’utilisateur à 
entrer du texte dans un Text Field, vous pouvez renseigner sa propriété Placeholder, 
comme indiqué à la figure 10.4. 



Figure 10.4 - Vous pouvez renseigner la propriété Placeholder pour inviter l’utilisa- 
teur à écrire 

Cette propriété est également utilisable en lecture et en écriture dans le code : 
l| monTextField . placeholder = ©"Entrez votre nom"; 

La première lettre de la propriété est minuscule. Ceci est une évidence, puisque 
les propriétés Xcode respectent la convention camelCase, mais cela va mieux 
en le disant tout de même ! 
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Saisir du texte sur plusieurs lignes 

Les Text View (figure 10.5) sont des zones de texte multiligne. Ces contrôles peuvent 
être affichés en lecture seule ou en lecture/écriture. Dans le deuxième cas, l’utilisateur 
pourra modifier leur contenu en utilisant le clavier du device. Le texte affiché dans un 
contrôle Text View utilise une seule police et une seule taille de caractères. Lorsqu’une 
adresse Web est insérée dans un Text View, elle peut être cliquée par l’utilisateur. La 
page correspondante s’ouvre alors dans le navigateur Safari. 

Enfin, lorsque le contenu d’un Text View est trop long pour être affiché en totalité, 
l’utilisateur peut utiliser une gestuelle de glisser pour faire défiler le texte dans le 
contrôle. 


Text 


Figure 10.5 - L’icône du contrôle Text View 

Les contrôles Text View relèvent de la classe UITextView. Consultez l’aide de cette 
classe pour en savoir plus sur ce contrôle. 


Afficher une image 

Le contrôle Image View (figure 10.6) permet d’afficher une image ou une animation, 
définie par l’affichage consécutif de plusieurs images. Les images sont chargées via des 
objets Ullmage. Une fois l’image chargée, il suffit de l’associer à une vue et à une 
taille pour l’afficher. Sans entrer dans les détails, sachez cependant que les images 
affichées dans un contrôle Image View peuvent provenir de l’album photo du device, 
des ressources de l’application, d’Internet ou être créées par l’application elle-même. 
Examinons ces quatre cas. 


Figure 10.6 - L’icône du Image View 


L’image est dans l’album photo du device 

Certains devices iOS disposent d’un appareil photo. Lorsqu’une photo est prise, elle 
est stockée dans l’album photo du device. Ce dernier est accessible par l’icône Photos. 
Malheureusement, lorsque vous cliquez dessus dans le simulateur iOS, l’album photo 
est vide, comme à la figure 10.7. 

Si vous voulez utiliser le simulateur pour vous entraîner à manipuler les photos de 
l’album, il est donc nécessaire de le remplir avant toute chose. Le simulateur vous 
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Figure 10.7 - Sur le simulateur, l’album photo est vide 

propose d’utiliser iTunes pour ajouter des photos dans l’album. Nous allons utiliser 
une tout autre technique. 

1. Trouvez un dossier qui contient des photos sur votre Mac. 

2. Glissez-déposez une photo sur l’album photo du simulateur. Quelques instants 
plus tard, la photo est affichée dans le navigateur Safari (1). 

3. Pointez la photo et maintenez le bouton gauche de la souris enfoncé jusqu’à ce 
qu’un menu apparaisse dans la partie inférieure de l’écran (2). 

4. Cliquez sur Save Image (3). 

5. Recommencez les étapes 2 à 4 pour ajouter une ou plusieurs autres photos. 

Si vous avez du mal à comprendre, reprenez ces instructions en observant la figure 10.8. 
Maintenant, voyons comment accéder à ces photos. 

Toute la magie réside dans l’utilisation d’un objet UlImagePickerController. Ce 
contrôleur permet entre autres de sélectionner une image dans une liste. C’est exacte- 
ment ce que nous voulons. La liste sera prise dans l’album photo. 

Définissez un nouveau projet de type Single View Application et donnez-lui le nom 
« imagePic.ker ». Cliquez sur MainStoryboard. storyboard dans le volet de navigation, 
puis ajoutez un contrôle Image View et un contrôle Rounded Rect But ton dans la zone 
d’édition. Redimensionnez-les pour obtenir quelque chose ressemblant à la figure 10.9. 

Reliez les deux contrôles au code en créant : 
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Figure 10.8 - Il est possible d’ajouter des photos facilement dans le simulateur 



Figure 10.9 - Placement des éléments 
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- l’outlet unelmage pour le contrôle UlImageView ; 

- l’action album pour le bouton. 

Le fichier ViewController .h devrait maintenant ressembler à ceci : 

1 # import <UIKit/UIKit.h> 

2 

3 ^interface ViewController : UlViewController 

4 (Sproperty (weak , nonatomic) IBOutlet UlImageView ♦unelmage ; 

5 

6 - ( IBAction) album :( id) sender ; 

7 ®end 


Étant donné que l’objet UlImagePickerController ne fait pas partie de la librairie 
d’objets Cocoa Touch, nous allons l’implémenter directement dans le code. Cliquez sur 
ViewController .h dans le volet de navigation et insérez la ligne suivante dans les 
variables d’instance : 

il UlImagePickerController ♦picker ; 


Le fichier ViewController .h devrait maintenant ressembler à ceci : 

1 # import <UIKit/UIKit.h> 

2 

3 ^interface ViewController : UlViewController 

4 { 

5 UlImagePickerController ♦picker ; 

6 } 

7 

8 Sproperty (weak, nonatomic) IBOutlet UlImageView ♦unelmage ; 


9 

10 - ( IBAction) album :( id) sender ; 

11 @end 


Lorsque l’utilisateur clique sur le bouton, nous voulons afficher la liste des images 
contenues dans l’album photo. Pour cela, nous allons agir sur la méthode événementielle 
album. Cliquez sur ViewController .m dans le volet de navigation puis complétez la 
méthode album comme suit : 

1 - ( IBAction) album :( id) sender { 

2 picker = [[UlImagePickerController alloc] init]; 

3 picker . delegate = self; 

4 picker . sourceType = 

UIImagePickerControllerSourceTypePhotoLibrary ; 

5 [self pre sentModalViewCont roller : picker animated : YES] ; 

6 } 

Si vous trouvez ce code compliqué, ne paniquez pas; je vais tout vous expliquer! 

La ligne 2 initialise l’objet picker en le reliant à la classe UlImagePickerController. 

La ligne 3 définit le delegate de l’objet picker. C’est ce delegate qui recevra les noti- 
fications lorsque l’utilisateur sélectionnera une image ou fermera l’Image Picker sans 
rien sélectionner. 
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La ligne 4 indique à l’Image Picker à quel endroit il doit rechercher la liste d’images. 
Vous l’aurez compris, le mot UIImagePickerControllerSourceTypePhotoLibrary fait 
référence à l’album photo. 

Enfin, la ligne 5 applique la méthode presentModalViewController à l’Image Picker. 
Ainsi, les vignettes de l’album seront affichées dans une fenêtre « modale », c’est-à-dire 
dans une fenêtre située au-dessus de l’application et qui rend l’accès à cette dernière 
impossible. 



Si vous remplacez UIImagePickerControllerSourceTypePhotoLibrary 
par UIImagePickerControllerSourceTypeCamera, le device prend une 
photo et la présente dans l'Image Picker. 


Je ne sais pas si vous avez remarqué le point d’exclamation de couleur jaune en face 
de l’instruction picker .delegate = self;. Il s’agit d’un avertissement. Si vous cli- 
quez sur le point d’exclamation, Xcode affiche des informations complémentaires sur le 
problème, comme à la figure 10.10. 

• - ( IBAc t lonlatbum: < î d ) tender { 

' - | | 1 1 I I ' . . ; t ' , - . l i | . 

I ■ I • ► I .delegftte ■ jelfj . Pjitmg Vt««CorMroll*r ttrong' la a» «HomfitliliU t»|>* id- eiN.ivmJlK>nConlroll»iD»4» u *i».UIIm.ig»l'l<k»>Conlro|l» 

picker .sourceType - UII««QePickerControUerSourceTypcPhotoUbrary ; 

[ielf presentModalVlewControllenp i krr aninated: YES) } 

I > 

Figure 10.10 - Xcode affiche des informations complémentaires sur le problème 
Reprenons l’intitulé du message : 


Passing ’ ViewController * const \ _strong ’ to parameter of 
incompatible type ’ id-CUINavigationControllerDelegate , 

UI ImagePi ckerCont r o 1 le rDe légat e > ’ 

Assigning to ’ id CUINavigat ionCont r ol lerDelegat e . 

UI ImagePi ckerCont ro llerDelegate > ’ from incompatible type ’ 
imagePi ckerViewCont roi 1er *’ 


Cela signifie que la gestion des événements liés à l’objet picker ne peut pas être prise 
en charge dans cette classe (= self dans l’instruction). 

En d’autres termes, cela signifie qu’il faut ajouter un delegate dans le fichier d’en-têtes 
pour traiter ces événements. Et même deux delegate, puisque UlImagePickerController 
est lié à UINavigationController. 

Pour régler ce problème, retournez dans le fichier ViewController .h et modifiez la 
déclaration de l’interface comme suit : 


î 


©interface ViewController : UlViewController < 
UINavigationControllerDelegate , 
UIImagePickerControllerDelegate > { 


} 
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Comme par magie, l’avertissement disparaît. En définissant ces deux delegate, nous 
avons indiqué au compilateur que les notifications reçues lors des manipulations de 
l’utilisateur dans l’Image Picker seront prises en compte par. . . ces delegate et traités 
dans la classe de l’application. 

Vous pouvez lancer l’application. Lorsque vous cliquez sur le bouton Accéder à 1 ’ album 
photo, l’album photo apparaît dans une liste. Cliquez dessus pour afficher les vignettes 
qui représentent son contenu, comme à la figure 10.11. 



Figure 10.11 - Cliquez sur les vignettes 


Consternation ! Lorsque vous cliquez sur une image, elle ne s’affiche pas sur le device ! 

Si vous réfléchissez un peu, c’est tout à fait normal. . . puisqu’aucune méthode n’a été 
écrite pour provoquer cet affichage. Définissez donc la méthode suivante : 

1 - ( void) imageP ickerC ont r o lier : ( UI ImageP icker Cont r o lier *) 

Picker didFinishPi ckingMediaWit hlnf o : ( NSDic t ionary *)info 

2 { 

3 unelmage . image = [info ob j ec t For Key : 

UI ImageP ickerC ont r o lier Or iginal Image ] ; 

4 [picker di smi s sModalViewC ont roller Animât ed : YES ] ; 

5 } 

Cette méthode est exécutée lorsque l’utilisateur choisit une vignette dans l’Image 
Picker. L’image choisie est alors affichée dans le contrôle Image View (ligne 3 du 
code). 

L’instruction suivante ferme la vue modale de l’Image Picker. 
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Dans tous vos développements d’applications iOS, la documentation Apple vous sera 
d’une très grande aide. Pour l’utiliser, posez-vous les questions suivantes : « Qu’est-ce 
que je veux faire? » et « De quoi dépend l’action que je veux réaliser? ». 

Ici par exemple, vous voulez afficher une image dans le contrôle ImageView lorsque 
l’utilisateur clique sur une vignette affichée dans l’Image Picker. Vous voulez donc 
capturer un événement. Et comme vous le savez, les événements sont gérés par. . . les 
delegate! C’est donc dans l’aide Apple sur un delegate que va se trouver la solution. 

De quel delegate s’agit-il? Eh bien, l’utilisateur va cliquer sur une vignette dans le 
contrôle Image Picker. Il s’agit donc du delegate UIImagePickerControllerDelegate. 

Comme indiqué à la figure 10.12, cliquez sur l’icône Organizer (1), dans l’angle supé- 
rieur droit de la fenêtre Xcode pour afficher la fenêtre d’aide. Tapez « UlImagePicker- 
ControllerDelegate » dans la zone de texte Rechercher (2) et appuyez sur la touche 
[ Entrée J de votre clavier. Plusieurs réponses sont affichées dans le volet gauche. Choi- 
sissez celle qui se trouve sous l’intitulé « Référencé » (3). Ça y est, vous avez fait le 
plus gros du travail. Il ne vous reste plus qu’à parcourir la page d’aide pour trouver la 
méthode recherchée (4). 



Figure 10.12 - Suivez ces instructions pour faire une recherche dans la documentation 

Pour finir, vous devez implémenter une autre méthode, qui sera exécutée si l’utilisateur 
clique sur Cancel pour annuler l’utilisation de l’Image Picker. Dans ce cas, il suffira 
de fermer la vue modale et de supprimer l’objet Picker. Voici le code à utiliser : 

1 - (void) imagePickerControllerDidCancel : ( UI ImagePickerContr oller 

*) Picker 
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2 { 

3 [picker dismissModalViewControllerAnimated : YES] ; 

4 unelmage . image = nil; 

5 } 

La ligne 3 ferme la vue modale de l’Image Picker. Quant à la ligne 4, elle efface l’image 
affichée dans le contrôle Image View. 

La méthode imagePickerControllerDidCancel a également été trouvée 
dans l'aide Apple sur le delegate UIImagePickerControllerDelegate. 

L’application est entièrement opérationnelle. Il ne vous reste plus qu’à l’exécuter et à 
choisir l’image à afficher. 



L’image est dans les ressources de l’application 

Une application iOS peut « embarquer » un ou plusieurs fichiers (images, sons, textes, 
etc.). Dans ce cas, on dit que ces fichiers font partie des ressources de l’application. 

Avant toute chose, il va nous falloir ajouter des ressources à l’application. Pour ce 
faire, cliquez du bouton droit sur l’icône qui représente l’application dans le volet de 
navigation et choisissez New group dans le menu contextuel, comme à la figure 10.13. 



Figure 10.13 - Choisissez New group dans le menu contextuel 

Donnez le nom « Resources » au nouveau groupe (avec un seul « s »). Maintenant, il vous 
suffit de glisser-déposer une image depuis le Finder dans le dossier « Resources », de 
cocher la case Copy items into destination group’ s folder (if needed) et de 
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valider en cliquant sur Finish (figure 10.14). L’image est alors intégrée aux ressources 
de l’application. 


Choose options for adding these files: 

* Destination Copy items into destination group's folder (if needed) 

Folders ©Create groups for any added folders 

OCreate folder references for any added folders 

Add to targets |V jà| imageRessources 

4 

Cancel Finish 


Figure 10.14 - Il est possible d’ajouter des images dans les ressources de l’application 

Lorsqu’une image se trouve dans les ressources de l’application (1), elle est directement 
accessible dans la propriété Image d’un contrôle Image View (2), comme le montre la 
figure 10.15. 

Vous pouvez également insérer une image dans un contrôle Image View en utilisant du 
code. Supposons que l’outlet monlmage ait été créé pour représenter un contrôle Image 
View et que l’image chien.jpg se trouve dans les ressources de l’application. Pour 
afficher cette image dans le contrôle Image View, vous utiliserez l’instruction suivante : 

l| monlmage . image = [Ullmage imageNamed : @ " chien . jpg "] ; 

Simple, non ? 


L’image est sur Internet 

Supposons que vous vouliez afficher dans un contrôle Image View l’image qui se trouve 
à l’adresse http : //www. siteduzero . com/uploads/f r/ftp/ iphone/zozor .png. 

Commencez par créer un nouveau projet de type Single View Application et donnez- 
lui le nom « imageURL ». Cliquez sur MainStoryboard. storyboard dans le volet de 
navigation, insérez un contrôle Image View dans le canevas et faites-lui occuper toute 
la surface disponible. Affichez le fichier d’en-têtes à côté du canevas en cliquant sur 
l’icône Show the Assistant editor dans la barre d’outils. Contrôle-glissez-déposez le 
contrôle Image View juste avant le Send du fichier d’en-têtes et créez l’outlet monlmage. 
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Figure 10.15 - L’image est accessible dans la propriété Image 

Le fichier imageURLViewController .h doit maintenant ressembler à ceci : 

1 # import <UIKit/UIKit.h> 

2 

3 ©interface ViewController : UlViewController 

4 

5 ©property (weak , nonatomic) IBOutlet UlImageView tmonlmage; 

6 ©end 

Pour afficher l’image dès l’ouverture de l’application, vous allez agir sur la méthode 
viewDidLoad. Cliquez sur ViewController .m dans le volet de navigation et insérez le 
code suivant dans la méthode viewDidLoad : 

1 - (void) viewDidLoad 

2 { 

3 [super viewDidLoad]; 

4 NSURL *unelmage = [NSURL URLWithString : © " http : // www . 

s i t eduzer o . com/ uploads /fr/ftp/iphone/zozor.png"] ; 

5 monlmage . image = [Ullmage imageWithData : [NSData 

dataWithContent s Of URL : une Image ] ] ; 

6 } 

Comme vous pouvez le voir, deux instructions ont été ajoutées à cette méthode. 

La première définit l’objet unelmage de type NSURL et y stocke l’URL de l’image en 
utilisant la méthode URLWithString. 

La deuxième instruction lit l’image sur le Web et l’affecte à l’objet monlmage. Re- 
marquez le chaînage des messages. Dans un premier temps, un objet NSData est ini- 
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tialisé avec l’image lue sur le Web ([NSData dataWithContentsOfURL : une Image] ). 
Dans un deuxième temps, cet objet est transformé en un objet Ullmage ([Ullmage 
imageWithData: . . .]. Enfin, dans un troisième temps, cet objet Ullmage est affecté 
au UlImageView monlmage (monlmage . image = ...). 

Vous pouvez lancer l’application, l’image est immédiatement affichée, comme à la figure 
10.16. 



Figure 10.16 - Zozor se lance au démarrage de l’application :-) 


L’image est stockée dans la sandbox 

Sur un device iOS, chaque application s’exécute dans une sandbox 1 qui lui est propre. 
Dans cet espace, il est possible de sauvegarder des informations de tous types : textes, 
images, URL, etc. Ces informations peuvent être rapidement retrouvées par l’applica- 
tion lorsqu’elle en a besoin. Cette technique est très pratique. Elle est généralement 
utilisée pour stocker l’état de l’application. Lorsqu’elle est à nouveau exécutée, l’utili- 
sateur la retrouve dans le même état que la dernière fois qu’il l’a utilisée. Dans cette 
section, je vais vous montrer comment stocker et lire une image dans la sandbox. À titre 
d’exemple, l’image sera lue sur le Web, sauvegardée dans la sandbox de l’application, 
puis affichée dans un Image View en la lisant dans la sandbox. 

Définissez un nouveau projet de type Single View Application et donnez-lui le nom 
«sandbox». Cliquez sur MainStoryboard. storyboard dans le volet de navigation, 

1. Sandbox signifie « bac à sable » en français. 
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insérez un contrôle Image View dans la zone d’édition et faites-lui occuper toute la 
surface disponible. Affichez le fichier d’en-têtes à côté de la zone d’édition en cliquant sur 
l’icône Show the Assistant editor dans la barre d’outils. Contrôle-glissez-déposez le 
contrôle Image View juste avant le @end du fichier d’en-têtes et créez l’outlet monlmage. 

Le fichier ViewController .h doit maintenant ressembler à ceci : 


1 # import <UIKit/UIKit.h> 

2 

3 ©interface ViewController : UlViewController 

4 

5 ©property (weak , nonatomic) IBOutlet UlImageView ♦monlmage ; 

6 ©end 


Il est temps de s’attaquer au fichier .m. Cliquez sur ViewController .m dans le volet 
de navigation et complétez la méthode viewDidLoad comme suit : 


î 

2 

3 

4 

5 

6 

7 

8 
9 

10 

11 


13 

14 

15 


- (void) viewDidLoad 

{ 

[super viewDidLoad]; 

//Récupération du fichier dans la sandbox et affichage dans 
le Image View 

NSString ♦limage = [NSHomeDirectory () 

s t r ingBy AppendingPat hComponent : © " Document s / image . png " ] ; 

Ullmage ♦recup = [Ullmage imageWi thCont ent s Of File : limage]; 

monlmage . image = recup; 

//Stockage d'une image Web dans la sandbox sous le nom "image 
.png" 

NSURL *unelmage = [NSURL URLWithString : © " http : // www . 
siteduzero .corn/ uploads /fr/ftp/iphone/zozor.png"] ; 

Ullmage *img = [Ullmage imageWithData : [NSData 
dataWi thCont ent s Of URL : une Image ] ] ; 

NSData* imageData = UI ImagePNGRepre sent at ion ( img ) ; 

[imageData writeToFile : limage atomically : NO] ; 


| Copier ce code 

[ Code web : 648113 y 

Toutes ces instructions ont de quoi donner la chair de poule ! Mais rassurez- vous, elles 
n’ont rien de bien sorcier et d’ici cinq petites minutes, vous les comprendrez parfaite- 
ment. Comme vous pouvez le voir, cette méthode contient deux blocs d’instructions. 

1. Le premier retrouve l’image stockée dans la sandbox et l’affiche dans le contrôle 
Image View. 

2. Le deuxième récupère une image sur le Web et la stocke dans la sandbox sous le 
nom image . png. 

Examinons les instructions de ces deux blocs. Le chemin du dossier dans lequel sont 
stockés les fichiers de la sandbox est retourné par la méthode NSHomeDirectory () . À 
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ce chemin, on ajoute le sous-dossier Documents et le fichier image. png. La concaténa- 
tion se fait via la méthode stringByAppendingPathComponent. Le chemin complet du 
fichier image. png est donc obtenu par l’expression suivante : 

1 [NSHomeDirect ory () StringByAppendingPathComponent : <§" Document s / 

image .png"] ; 

Pour faciliter la manipulation de ce chemin, il est stocké dans un objet NSString de 
nom limage : 

1 NSString ♦limage = [NSHomeDirect ory ( ) 

StringByAppendingPathComponent : @ " Document s / image . png " ] ; 

Pour récupérer l’image qui a été stockée à cet emplacement, il suffit d’utiliser la méthode 
imageWithContentsOf File. L’image est stockée dans un objet Ullmage de nom recup : 

l| Ullmage ♦recup = [Ullmage imageWithCont ent s Of File : limage]; 

L’étape finale consiste à affecter l’objet recup à la propriété image du contrôle Image 
View, ce qui provoque l’affichage de l’image : 

l| monlmage . image = recup; 

Jusque-là, tout va bien. Attaquons-nous au stockage de l’image dans la sandbox. La pre- 
mière instruction définit l’objet NSURL unelmage et y stocke l’adresse URL de l’image 
à rapatrier depuis le Web : 

1 NSURL ♦unelmage = [NSURL URLWithString : @ "http : //www . siteduzero 

. com/uploads /fr/ftp/iphone/zozor.png"] ; 

La deuxième instruction rapatrie l’image Web et la stocke dans un objet Ullmage de 
nom img : 

I Ullmage ♦img = [Ullmage imageWithData : [NSData 

dat aWi thC ont ent s Of URL : unelmage ] ] ; 

Cette technique a déjà été étudiée dans la section précédente. C’est pourquoi nous ne 
nous y attarderons pas. Malheureusement, il est impossible de stocker un objet Ullmage 
dans la sandbox. Il faut au préalable le convertir en un objet NSData. Pour cela, vous 
utiliserez la méthode : 

- UIImagePNGRepresentation si l’image est au format PNG; 

- UIImageJPEGRepresentation si l’image est au format JPEG. 

Ici, l’image étant au format PNG, nous utilisons la méthode suivante : 
l| NSData^ imageData = UIImagePNGRepresentation ( img) ; 

II ne reste plus qu’à enregistrer l’objet NSData imageData dans la sandbox avec la 
méthode writeToFile : 

l| [imageData wr iteToFile : limage atomically : NO] ; 
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Lancez l’application. 

Lors de la première exécution, l’écran reste désespérément blanc. Quelle en est la raison 
selon vous ? Rappelez-vous : le premier bloc d’instructions affiche l’image stockée dans 
la sandbox et le deuxième stocke l’image de Zozor dans la sandbox. Lors de la première 
exécution, Zozor n’a pas encore été mémorisé dans la sandbox. Quittez le simulateur 
avec la commande Quitter Simulateur iOS dans le menu Simulateur iOS et relan- 
cez l’application en cliquant sur Run dans Xcode. Cette fois-ci, Zozor est bien affiché 
dans le contrôle Image View. 

Vous trouverez ci-après les codes de cette application. 


ViewController.h 

1 # import <UIKit/UIKit.h> 

2 

3 ^interface ViewController : UlViewController 

4 

5 Sproperty (weak , nonatomic) IBOutlet UlImageView tmonlmage; 

6 Oend 

ViewController. m 


1 

2 

3 

4 

5 

6 

7 

8 
9 

10 

11 

12 

13 

14 

15 

16 

17 

18 

19 

20 
21 
22 

23 


#import "ViewController.h" 

@ implement at ion ViewController 
Ssynthesize monlmage ; 

- ( void) didRecei veMemoryWarning 

{ 

[super didReceiveMemoryWarning] ; 

// Release any cached data, images , etc that aren ' t in use. 

} 

#pragma mark - View lifecycle 

- ( void) viewDidLoad 

{ 

[super viewDidLoad]; 

//Récupération du fichier dans la sandbox et affichage dans 
le Image View 

NSString ♦limage = [NSHomeDirectory () 

s t r ingBy AppendingPat hComponent : @ " Document s / image . png " ] ; 

Ullmage ♦recup = [Ullmage imageWithCont ent s Of File : limage]; 
monlmage . image = recup; 

//Stockage d'une image Web dans la sandbox sous le nom 
image . png 

MSURL ♦unelmage = [NSURL URLWithString : @ " ht tp : // www . 
siteduzero .corn/ uploads / fr/ ftp/iphone/ zozor . png " ] ; 
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43 
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46 

47 

48 

49 

50 

51 

52 
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54 

55 

56 

57 

58 

59 

60 

61 

62 
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Ullmage * img = [Ullmage imageWithData : [NSData 
dat aWithCont ent s Of URL : une Image ] ] ; 

NSData* imageData = UIImagePNGRepresentation ( img) ; 
[imageData writ eToFile : limage atomically : NO] ; 


{ 


} 

{ 

} 

{ 

} 


(void) viewDidUnload 


[s 

elf s 

etMonlmage : 

nil] ; 


[s 

uper 

viewDidUnlo 

ad] ; 


// 

Rele 

ase any ret 

ained 

subviews 

// 

e.g. 

self . myOut 

let = 

nil ; 

( voi 

d ) vie 

wWillAppear 

: (B00L 

) animated 

[s 

uper 

viewWillApp 

ear : an 

imated] ; 

(voi 

d ) vie 

wDidAppear : 

(B00L) 

animated 

[s 

uper 

viewDidAppe 

ar : ani 

mated] ; 


the main view . 


- (void)viewWillDisappear:(BOOL) an i mat ed 

{ 

[super viewWillDisappear : animated] ; 

} 


- (void) viewDidDisappear : (B00L) animated 

{ 

[super viewDidDisappear : animated] ; 

} 


- (B00L) shouldAutorotateToInterfaceOrientation : ( 

UI Interface Orientât ion) interface Orientât ion 

{ 

// Return YES for supported orientations 
return ( interf aceOrientation != 

UIInterfaceOrientationPortraitUpsideDown) ; 

} 


®end 


Copier ce code 
^Code web : 860881 
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En résumé 

- Les contrôles Label sont utilisés pour afficher des textes courts sur une ou plusieurs 
lignes. Leur contenu ne peut pas être modifié par l’utilisateur. Les caractéristiques 
d’un Label peuvent être définies dans Interface Builder ou dans le code. 

- Les Text Field sont des zones de texte monoligne. Ils sont utilisés pour saisir des 
données textuelles courtes, telles qu’un nom ou un mot de passe par exemple. 

- Le texte saisi dans un contrôle Text Field est accessible en lecture et en écriture à 
travers sa propriété text. 

- Si vous avez besoin d’une zone de texte multilignes, utilisez des contrôles Text View. 

- Le contrôle Image View permet d’afficher une image ou une animation. Les images 
peuvent être chargées à partir de l’album photo, des ressources de l’application, du 
Web ou encore de la sandbox. 
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Difficulté : m 

D ans le chapitre précédent, nous avons appris à travailler avec des contrôles liés à du 
texte et des images. Mais peut-être aimeriez-vous travailler sur d'autres contrôles. 
C'est justement ce que je vais vous montrer dans ce chapitre. 

Nous allons voir comment afficher un contenu Web, une carte, ou encore demander son 
avis à l'utilisateur. Et, tout comme pour le chapitre précédent, n'hésitez pas à vous reporter 
à celui-ci lors de vos futurs développements d'applications afin d'avoir un cas concret sous 
les yeux. 
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Afficher du contenu Web 

Le contrôle Web View (figure 11.1) est utilisé pour intégrer du contenu Web dans une 
application. 



Figure 11.1 - L’icône du contrôle Web View 


Pour afficher une page Web, vous appliquerez la méthode loadRequest à ce contrôle. 
Par exemple, pour afficher le moteur de recherche Google dans un contrôle Web View 
nommé wv, vous utiliserez l’instruction suivante : 

1 [wv loadRequest : [NSURLRequest requestWithURL : [NSURL 
URLWithString : @ " http://www.google.fr"]]] ; 


La syntaxe est un peu surprenante, je vous l’accorde, mais il « suffit » de dire que : 

- la méthode loadRequest s’applique sur un objet de type NSURLRequest ; 

- un objet NSURLRequest est obtenu en appliquant la méthode requestWithURL sur 
un objet de type NSURL ; 

- un objet NSURL est obtenu en appliquant la méthode URLWithString sur une chaîne 
de caractères contenant l’adresse URL désirée. 

Ainsi, le message le plus interne ([NSURL URLWithString :@"http: //www. google.fr"]) 
définit un objet de type NSURL et l’initialise avec l’URL de Google : 

l| [NSURL URLWithString http : //www . google . fr " ] 

Cet objet est passé à la méthode requestWithURL qui est appliquée sur un objet 
NSURLRequest : 

l| [NSURLRequest requestWithURL: objet NSURL]; 

Enfin, l’objet retourné est passé à la méthode loadRequest qui est appliquée à l’objet 
Web View wv : 

il [wv loadRequest: objet NSURLRequest]; 


Cette instruction se place dans le fichier d’en-têtes de votre application, comme ceci : 


î 

2 

3 

4 

5 


{ 


} 


(void) viewDidLoad 

[super viewDidLoad]; 

[wv loadRequest : [NSURLRequest requestWithURL: 
URLWithString : @ " http://www.google.fr"]]] ; 


[NSURL 


Il ne vous reste alors plus qu’à lancer l’application : vous venez de créer un navigateur 
Web qui démarre automatiquement sur le moteur de recherche Google ! 
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Afficher une carte 


Le contrôle Map View (figure 11.2) permet d’afficher une carte, comme dans l’applica- 
tion Maps. 



Figure 11.2 - L’icône du contrôle Map View 


En utilisant les méthodes de la classe MKMapView, vous pouvez, entre autres, centrer 
la carte sur une coordonnée spécifique, choisir la taille de la zone à afficher ou encore 
ajouter des informations personnalisées sur la carte. 

Dans cette section, je vais vous montrer comment afficher la carte centrée sur Paris. Le 
but du jeu est d’afficher quelque chose ressemblant à la figure 11.3 sur votre device. 



□ 


Figure 11.3 - Paris est centré sur la carte 


Définissez un nouveau projet de type Single View Application et donnez-lui le nom 
« map ». Une fois n’est pas coutume, nous n’allons pas utiliser Interface Builder dans 
ce projet ! 
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Ajout du framework MapKit à l’application 

Pour pouvoir afficher une carte dans la fenêtre de votre application, vous devez ajou- 
ter le framework MapKit à l’application. Pour ce faire, rien de plus simple : lisez les 
instructions suivantes en vous aidant de la figure 11.4. 

- Sélectionnez la première entrée dans le volet de navigation. Ici, l’entrée map (1). 

- Sélectionnez l’onglet Build Phases dans le volet droit (2). 

- Développez le dossier Link Binary with Libraries (3). 

- Cliquez sur + (4). 

- Ajoutez le framework désiré (5). 

- Validez en cliquant sur Add (6). 



Figure 11.4 - Pour afficher une carte dans une application, il lui faut le framework 
MapKit 


Modification du fichier .h 

Cliquez sur ViewController .h dans le volet de navigation et ajoutez une instruction 
#import pour accéder au framework MapKit : 

l| #import <MapKit /MapKit . h> 

Déclarez ensuite un objet de type MKMapView : 
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l| MKMapView *mapView; 

Si vous avez suivi mes indications, le fichier mapViewController .h devrait maintenant 
avoir l’allure suivante : 

1 # import <UIKit/UIKit.h> 

2 #import <MapKit /MapKit . h> 

3 

4 ©interface ViewCont r oller : UlViewController 

5 { 

6 MKMapView *mapView; 

7 } 

8 

9 ©end 


Modification du fichier .m 


Cliquez sur ViewController .m dans le volet de navigation. Vous allez maintenant ini- 
tialiser, personnaliser et afficher l’objet mapView. Ce traitement se fera dans la méthode 
viewDidLoad. Complétez cette méthode comme ceci : 


1 

2 

3 

4 

5 

6 

7 

8 
9 

10 

11 

12 

13 

14 

15 

16 

17 

18 

19 

20 
21 
22 

23 

24 

25 

26 
27 


- ( vo id ) viewDidLoad 

{ 

[super viewDidLoad]; 

// Instancier la carte 

mapView = [[MKMapView alloc] initWithFrame : self . view . bounds ] ; 

// Définir le zoom 

MKCoordinateSpan span; 
span . latitudeDelta = 0 . 5 ; 
span . longitudeDelta = 0 . 5 ; 

// Définir les coordonnées de Paris 

CLLocationCoordinate2D parisCoordinates ; 
parisCoordinates . latitude = 48 . 858391 ; 
parisCoordinates . longitude = 2 . 35279 ; 

MKCoordinateRegion parisRegion; 
parisRegion . span= span ; 

parisRegion. center=parisCoordinates ; 

// Centrer la carte sur Paris 

[mapView setRegion : parisRegion animated : TRUE] ; 

// Ajouter la carte à la vue 

[self. view insert Sub view : mapView atlndex:0]; 
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> 


Cela fait beaucoup d’instructions n’est-ce pas ? Examinons-les calmement et vous verrez 
qu’il n’y a rien d’insurmontable. . . 

L’instruction de la ligne 6 réserve l’espace nécessaire en mémoire pour loger l’objet 
MKMapView mapView. Il n’y a rien de sorcier là-dedans : c’est juste la syntaxe (un peu 
lourde je vous l’accorde!) à utiliser : 

l| mapView = [[MKMapView alloc] initWithFrame : self . view . bounds ] ; 

Le premier message réserve la mémoire pour un objet MKMapView ( [MKMapView alloc] ). 
Le deuxième message utilise la méthode initWithFrame pour définir les dimensions du 
rectangle dans lequel sera affichée la vue. Ici, self .view, bounds signifie la taille de la 
vue courante. 

Le bloc d’instructions suivant définit la structure span de type MKCoordinateSpan : 
l| MKCoordinateSpan span; 

Par son intermédiaire, on définit le nombre de degrés en latitude (c’est-à-dire du nord 
au sud) et en longitude (c’est-à-dire de l’ouest à l’est) de la zone d’affichage : 

1 span . lat itudeDelta = 0 . 5 ; 

2 span . longitudeDelta = 0 . 5 ; 

À titre d’information : 

- 1 degré de latitude correspond environ à 111 kilomètres. 

- 1 degré de longitude correspond environ à 111 kilomètres à l’équateur et à 0 kilomètre 
aux pôles. 

Le bloc d’instructions suivant définit les coordonnées de la ville de Paris. Pour cela, la 
structure parisCoordinates, de type CLLocationCoordinate2D est instanciée : 

l| CLLo cat ionCo ordinat e 2D parisCoordinates; 

Puis les coordonnées de la ville de Paris y sont stockées : 

1 parisCoordinates . latitude = 48 . 833 ; 

2 parisCoordinates . longitude = 2 . 333 ; 


Copier ce code 
Code web : 932827 



Pour avoir les coordonnées d'un endroit du globe, vous pouvez vous rendre sur 
Google Maps. Une fois repéré l'endroit, faites un clic droit avec votre souris 
et cliquez sur Plus d’infos sur cet endroit. Dans le champ texte au- 
dessus de la carte, les coordonnées s'affichent. 


(Google Maps 

\ 

[Code web : 475144 

y 


Le bloc d’instructions suivant définit le centre de l’affichage et le niveau de détail. Pour 
cela, la structure parisRegion de type MKCoordinateRegion est instanciée : 
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l| MKCoordinateRegion parisRegion; 

Puis le niveau de détail est précisé en faisant référence à la structure map définie pré- 
cédemment : 

l| parisRegion . span = span ; 

Le centre de l’affichage est défini en faisant référence à la structure parisCoordinates 
définie précédemment : 

I | parisRegion . center = parisCoordinates ; 

II ne reste plus qu’à envoyer un message à l’objet mapView pour lui demander d’afficher 
la région définie dans la structure parisRegion définie précédemment. Ici, le paramètre 
animated étant initialisé à TRUE, l’affichage se fera avec une animation : 

l| [mapView setRegion : parisRegion animated : TRUE] ; 

Pour terminer, la vue mapView est ajoutée à l’application, ce qui provoque son affichage : 
l| [self. view insertSubview : mapView atlndex:0]; 

Et comme vous avez été sages, je vous donne les codes de l’application. :-) 


ViewController.h 


# import <UIKit/UIKit ,h> 

#import <MapKit /MapKit . h> 

©interface ViewCont r oller : UlViewController 

{ 

MKMapView ♦mapView; 


3end 

ViewController.m 

#import "ViewController.h" 
©implémentation ViewController 


1 

2 

3 

4 

5 

6 

7 

8 
9 

10 

11 

12 

13 


- ( void ) di dRe ce i veMemory Warning 

{ 

[super didReceiveMemoryïarning] ; 

// Release any cached data, images, etc that aren ' t in use 

} 

#pragma mark - View lifecycle 

- ( vo id ) viewDidLoad 
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[super viewDidLoad] ; 

// instancier la carte 

mapView = [[MKMapView alloc] initWithFrame : self . view . bounds ] ; 

//définir le zoom 

MKCoordinateSpan span; 
s pan . latitudeDelta = 0 . 5 ; 
span . longitudeDelta=0 . 5 ; 

//définir les coordonnées de Paris 

CLLocationCoordinate2D parisCoordinates ; 
parisCoordinates . latitude = 48 . 858391 ; 
parisCoordinates . longitude = 2 . 35279 ; 


MKCoordinateRegion parisRegion; 
parisRegion . span= span ; 

parisRegion . center=parisCoordinates ; 


} 

{ 

} 

{ 

} 

{ 

} 

{ 

} 


// ce 

ntrer la carte 

sur 

Paris 


[mapV 

iew setRegion:p 

ar is 

Région animated: 

TRUE] ; 

// a j 

outer la carte 

à la 

vue 


[self 

.view insertSub 

view 

: mapView atlndex 

: 0 ] ; 

(void 

) viewDidUnload 




[supe 

r viewDidUnload 

] ; 



// Re 

lease any retai 

ned 

subviews of the 

main view 

// e. 

g . self . myOut le 

t = 

nil ; 


(void 

) viewWill Appear 

: (B0 

0L ) animated 


[supe 

r viewWillAppea 

r : an 

imated] ; 


(void 

) viewDidAppear : 

(B00L ) animated 


[supe 

r viewDidAppear 

: ani 

mated] ; 


(void 

) viewWillDisapp 

ear : 

(B00L) animated 



[super viewWillDisappear : animated] ; 


- (void) viewDidDisappear : (B00L) animated 

{ 


QUAND LE CONTENU DÉPASSE LA TAILLE DU CONTRÔLE, DE LA VUE OU 

DE LA FENÊTRE 


64 

65 

66 

67 

68 

69 

70 

71 

72 
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[super viewDidDisappear : animated] ; 

} 

- (B00L) shouldAutorotateToInterfaceOrientation : ( 

UI Interface Orientât ion) interface Orientât ion 

{ 

// Return YES for supported orientations 
return ( inter f aceOrientat ion != 

UIInterfaceOrientationPortraitUpsideDown) ; 

} 

©end 


| Copier ce code 

[ Code web : 548736 j 

Quand le contenu dépasse la taille du contrôle, de la 
vue ou de la fenêtre 


Vous utiliserez un contrôle Scroll View (figure 11.5) pour afficher un contenu qui est 
plus grand que la fenêtre de l’application. Les utilisateurs pourront alors faire glisser la 
fenêtre de visualisation sur le contenu, mais aussi zoomer vers l’avant et vers l’arrière 
en pinçant/étirant l’écran avec deux doigts. 



Figure 11.5 - L’icône du contrôle Scroll View 

Pour illustrer le fonctionnement de ce contrôle, nous allons y insérer un contrôle Image 
View de taille supérieure à celle du Scroll View. L’utilisateur pourra alors se déplacer 
dans l’image en utilisant des gestuelles de glisser. 

Définissez un projet de type Single View Application et donnez-lui le nom « usv ». 
Dans le volet de navigation, cliquez sur MainStoryboard. storyboard, puis ajoutez un 
contrôle Scroll View au canevas de l’application. 

Cliquez sur l’icône Show the Assistant editor dans la barre d’outils de Xcode, 
contrôle-glissez-déposez le contrôle Scroll View du canevas sur le fichier d’en-têtes, 
juste au-dessus de l’instruction @end et définissez l’outlet scrollView. 

Le fichier d’en-têtes doit maintenant avoir l’allure suivante : 

1 # import <UIKit/UIKit.h> 

2 

3 ©interface ViewCont r oller : UlViewController 

4 ©property (weak , nonatomic) IBOutlet UlView *scrollView; 

5 

6 ©end 
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Comme à la figure 11.6, vous allez maintenant superposer une image au contrôle Scroll 
View : 

- déposez un contrôle Image View sur le contrôle Scroll View (1) ; 

- choisissez une image de grande taille et insérez-la dans les ressources de l’application 

(2); 

- affectez-la au contrôle Image View en agissant sur sa propriété Image (3) ; 

- visualisez la partie supérieure gauche de l’image en choisissant Top Left dans la liste 
déroulante Mode (4). 
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Figure 11.6 - On prépare notre application avec une image de grande taille 

Sélectionnez le fichier ViewController .m dans le volet de navigation et complétez la 
méthode viewDidLoad comme suit : 

1 - (void) viewDidLoad 

2 { 

3 [super viewDidLoad]; 

4 [scrollView set Scr ollEnabled : YES ] ; 

5 [scrollView set Cont ent S ize : CGSizeMake ( 819 , 1 024 ) ] ; 

6 } 

Le premier message destiné à l’objet scrollView autorise les scrollings : 
l| [scrollView set Scr o HEnabled : YES ] ; 

Le deuxième définit la taille du scrolling. Ici, elle a été arbitrairement fixée à 819x1024 
pixels : 
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l| [scrollView set Content Size : CGSizeMake (819 , 1024 )] ; 

Pour que la zone d’affichage du contrôle Scroll View s’adapte exactement à celle de 
l’image, vous pouvez utiliser l’instruction suivante : 

1 [scrollView set Content Size : CGSizeMake ( image View . image . size . 
width , image View . image .size.height)] ; 

Si vous optez pour une adaptation automatique de la taille du Scroll View, 
pensez à définir l'outlet imageView pour le contrôle Image View, sans quoi 
une erreur apparaîtra dans Xcode sur cette nouvelle ligne. 

Voici le code complet, que vous pouvez télécharger grâce à un code web. 



ViewController.h 


1 

2 

3 

4 

5 

6 
7 


# import CUIKit/UIKit .h> 


©interface ViewCont r oller : 
©property (weak , nonatomic) 
©property (weak, nonatomic) 


UlViewController 

IBOutlet UIScrollView ♦scrollView; 
IBOutlet UlImageView ♦imageView; 


©end 


ViewController.m 


1 

2 

3 

4 

5 

6 

7 

8 
9 

10 

11 

12 

13 

14 

15 

16 

17 

18 

19 

20 

21 


#import "ViewController.h" 

©implémentation ViewController 
©synthesize scrollView; 

©synthesize imageView; 

- ( void ) di dRe ce i veMemory Warning 

{ 

[super didReceiveMemoryïarning] ; 

// Release any cached data, images, etc that aren ' t in use. 

} 

#pragma mark - View lifecycle 

- ( vo id ) viewDidLoad 

{ 

[super viewDidLoad]; 

[scrollView se t Scr ollEnabled : YES ] ; 

/ / [scrollView setContentSize : CGSizeMake (819 , 1024) ] ; 

[scrollView setContentSize : CGSizeMake ( imageV iew . image . size . 
width, imageView. image .size.height)] ; 

} 
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22 

23 

24 

25 

26 

27 

28 

29 

30 

31 

32 

33 

34 

35 

36 

37 

38 

39 

40 

41 

42 

43 

44 

45 

46 

47 

48 

49 

50 

51 

52 

53 

54 

55 

56 

57 

58 


- (void) viewDidUnload 

{ 

[self setScrollView : nil] ; 

[self s et ImageView : nil ] ; 

[super viewDidUnload]; 

// Release any retained subviews of the main view . 
// e.g. self . myOut let = nil; 

} 

- (void) viewWill Appear : (B00L) animated 

{ 

[super viewWillAppear : animated] ; 

} 

- (void) viewDidAppear : (B00L) animated 

{ 

[super viewDidAppear : animated] ; 

} 

- (void) viewWillDis appear : (B00L) animated 

{ 

[super viewWillDisappear : animated] ; 

} 

- (void) viewDidDisappear : (B00L) animated 

{ 

[super viewDidDisappear : animated] ; 

} 

- (B00L) shouldAutorotateTo Interface Orientât ion : ( 

UlInterfaceOrientation) interf aceOrientation 

{ 

// Return YES for supported orientations 
return ( int erf ace Or ient at ion ! = 

UIInterfaceOrientationPortraitUpsideDown) ; 

} 


Oend 


j Copier ce code 

[ Code web : 547909 , 

Demander son avis à l’utilisateur 


Il est parfois utile d’afficher une boîte de dialogue modale (c’est-à-dire qui se superpose 
à la fenêtre de l’application et qui y interdit toute action) pour demander à l’utilisa- 
teur de prendre une décision. Par exemple, pour confirmer l’arrêt de l’application ou 
l’écrasement d’un fichier. Deux classes peuvent être utilisées à cet effet : UIAlertView 
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et UIActionSheet. 


Une boîte de dialogue modale avec un contrôle UIAlertView 


Définissez un projet basé sur le modèle Single View Application et donnez-lui le 
nom « alerte ». Dans le volet de navigation, cliquez sur MainStoryboard. storyboard 
et ajoutez un contrôle Label à la vue. Double-cliquez dans le Label et tapez « Cliquez 
sur un bouton ». Définissez un outlet pour le Label et donnez-lui le nom status. 

Vous allez maintenant ajouter quelques lignes de code dans la méthode viewDidLoad 
pour provoquer l’affichage de la boîte de dialogue modale. Cliquez sur ViewController . m 
dans le volet de navigation et complétez la méthode viewDidLoad comme suit : 


1 

2 

3 

4 

5 

6 

7 

8 
9 

10 


- ( vo id ) viewDidLoad 

{ 

[super viewDidLoad]; 

UIAlertView *alert = [[UIAlertView alloc] 
initWithTitle : @ "Voulez -vous arrêter ?" 

message :®"Confirmez que vous voulez quitter l'application 
delegate : self 

cancelBut t onTitle : Annuler " otherButtonTitles :nil] ; 
[alert addButt onWithTit le :@"Confirmer"] ; 

[alert show] ; 

} 


Les lignes 4 à 7 définissent l’objet alert de type UIAlertView. 

Cet objet est initialisé avec : 

- un titre : initWithTitle : @"Voulez-vous arrêter?"; 

- un message : message : @"Confirmez que vous voulez quitter l’application"; 

- un bouton Annuler : cancelButtonTitle : @"Annuler". 

Les événements qui lui sont liés sont traités dans la classe alert ViewController elle- 
même (delegate : self ). 

L’instruction suivante ajoute le bouton Confirmer à la boîte de dialogue : 
l| [alert addButt onWithTit le : @ " Conf irmer "] ; 

Enfin, la dernière instruction affiche la boîte de dialogue : 

1 | [alert show] ; 

Vous pouvez lancer l’application et voir qu’elle fonctionne à la perfection (figure 11.7), 
si ce n’est que les boutons ne produisent aucun effet. 

Nous allons régler ce problème en définissant une méthode action. Ajoutez le code 
suivant au fichier alert ViewController .m : 

1 - ( vo id ) alert View :( UIAlertView *)alertView 

didDismissWithButtonlndex : (NSInteger) buttonlndex { 

2 if (buttonlndex == 0) 
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Figure 11.7 - Notre application se lance. . . mais les boutons ne produisent aucun effet 

3 status . text = ©"Vous avez cliqué sur Annuler"; 

4 else 

5 status . text = ©"Vous avez cliqué sur Confirmer"; 

6 } 

La méthode alertView:didDismissWith.ButtonIndex est exécutée lorsque l’utilisa- 
teur clique sur un des boutons de la boîte de dialogue modale. L’entier buttonlndex 
représente l’index du bouton cliqué. Il vaut : 

- 0 si le bouton Annuler a été cliqué ; 

- 1 si le bouton Confirmer a été cliqué. 

En fonction du bouton cliqué, un message ou un autre est affiché dans le contrôle Label. 
Voici le code de l’application. 


ViewController.h 

1 # import <UIKit/UIKit.h> 

2 

3 ©interface ViewController : UlViewController 

4 ©property (weak , nonatomic) IBOutlet UILabel *status; 

5 

6 ©end 
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iewController.m 


#import " V iewC ont r oller . h" 

Simplementation ViewController 
Ssynthesize status; 

- ( vo id ) didRe cei veMemory Warning 

{ 

[super didReceiveMemoryïarning] ; 

// Release any cached data, images, etc that aren't in use. 

} 

#pragma mark - View lifecycle 

- ( void ) viewDidLoad 

{ 

[super viewDidLoad]; 

UIAlertView *alert = [ [UlâlertView alloc] 

initWithTitle : @ "Voulez -vous arrêter ?" 

message :®"Confirmez que vous voulez quitter l'application" 
delegate : self 

cancelBut t onTitle : Annuler " otherButtonTitles :nil] ; 

[alert addButt onWithTit le :@"Confirmer"] ; 

[alert show] ; 

} 

- ( vo id ) alert View :( UIAlertView *) alert View 

didDismissWithButtonlndex : (NSInteger) buttonlndex { 
if (buttonlndex == 0) 

status . text = ®"Vous avez cliqué sur Annuler"; 
else 

status . text = ®"Vous avez cliqué sur Confirmer"; 

} 

- ( vo id ) viewDidUnload 

{ 

[self setStatus : nil] ; 

[super viewDidUnload]; 

// Release any retained subviews of the main view . 

// e.g. self . myOutlet = nil; 

} 

- (void)viewWillAppear:(B00L) an i mat ed 

{ 

[super viewWillAppear : animated] ; 

} 

- (void) viewDidAppear : (B00L) animated 

{ 
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[super viewDidAppear : animated] ; 

} 

- (void) viewWillDisappear : (B00L) animated 

{ 

[super viewWillDisappear : animated] ; 

} 

- (void) viewDidDisappear : (B00L) animated 

{ 

[super viewDidDisappear : animated] ; 

} 

- (B00L) shouldAutorotateTo Interface Orientât ion : ( 

UlInterfaceOrientation) interf aceûrientation 

{ 

// Return YES for supported orientations 
return ( int erf ace Or ient at ion ! = 

UIInterfaceOrientationPortraitUpsideDown) ; 

} 

Oend 


| Copier ce code 

[ Code web : 584901 , 

Une boîte de dialogue modale avec un contrôle UIActionSheet 

Une variante du contrôle UIAlertView consiste à utiliser le contrôle UIActionSheet. 
Ce dernier affiche une vue modale qui se superpose à la vue actuelle dans la partie 
inférieure de la fenêtre. 

Définissez un projet basé sur le modèle Single View Application et donnez-lui le nom 
« actionSheet ». Dans le volet de navigation, cliquez sur MainStoryboard. storyboard 
et ajoutez un contrôle Label à la vue. Double-cliquez sur le Label et tapez « Appuyez 
sur un bouton ». Enfin, définissez un outlet pour ce Label et donnez-lui le nom status. 

Vous allez maintenant ajouter quelques lignes de code dans la méthode viewDidLoad 
pour provoquer l’affichage de la vue modale. Cliquez sur ViewController .m dans le 
volet de navigation, et complétez la méthode viewDidLoad comme suit : 

1 - (void) viewDidLoad 

2 { 

3 [super viewDidLoad]; 

4 UIActionSheet ^actionSheet = [[UIActionSheet alloc] 

initWithTit le : @ " Voulez - vous arrêter l'application ?" 

5 delegate : self cancelButtonTitle : nil des t ruct i veBut t onTit le : 

nil 

6 o therBut t onTi t les : @ " Oui " , @"Non",@"Je ne sais pas", nil]; 

7 ac t ionSheet . act ionShee t St y le = UI Act ionShee t St y leB lackOpaque ; 

8 act ionSheet . des t ruct i veBut t onlndex = 1; 
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9 

10 } 


[actionSheet showInView : self . view] ; 


La première instruction définit l’objet actionSheet de type UIActionSheet. 

Cet objet est initialisé avec : 

- un titre : initWithTitle : @"Voulez-vous arrêter l’application?"; 

- trois boutons : otherButtonTitles : @"0ui" , @"Non",@"Je ne sais pas", nil). 

Le traitement du contrôle se fait dans la classe actionSheet ViewController elle- 
même : delegate : self . 

L’instruction suivante définit le style du contrôle : 

l| actionSheet . actionSheetStyle = UIActionSheetStyleBlackOpaque; 

Les valeurs possibles pour la propriété actionSheetStyle sont les suivantes 1 : 

- UIActionSheetStyleAutomatic ; 

- UIActionSheetStyleDef ault ; 

- UIActionSheetStyleBlackTranslucent ; 

- UIActionSheetStyleBlackOpaque. 

L’instruction suivante indique que le bouton d’index 1 (le deuxième en d’autres termes) 
doit être différencié des autres, car il présente un caractère particulier. Ce bouton 
apparaît en rouge. 

1 actionSheet . destructiveButtonlndex = 1; 



Dans cet exemple, le bouton n'a rien de particulier. Mais imaginez par contre 
que vous demandiez à l'utilisateur de supprimer une table de scores dans un 
jeu ou d'effacer un fichier. Un tel bouton pourrait alors être très utile! 


L’instruction suivante ajoute la vue modale dans la vue courante : 
l| [actionSheet showInView : self . view] ; 

Lancez l’application dans le simulateur. Vous devriez obtenir quelque chose ressemblant 
à la figure 11.8. 

L'application fonctionne, mais un triangle de couleur jaune apparaît dans le 
code, comme à la figure 11.9. Est-ce que j'aurais raté quelque chose? 

Observez d’un peu plus près le message d’erreur. Xcode nous indique que la classe 
ViewController n’implémente pas le protocole UIActionSheetDelegate et ne peut 
donc pas répondre aux événements générés par l’objet actionSheet. Qu’à cela ne 
tienne : cliquez sur ViewController .h dans le volet de navigation et ajoutez le proto- 
cole demandé dans la déclaration de l’interface : 

1. N’hésitez pas à les tester! 
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Figure 11.8 - L’application lancée dans le simulateur 


- ( void) viewDidLoad 

{ Sending 'ViewController ’const _strong‘ to parameter of incompatible type 'id<UlAct»onSheetDelegate>' 

[super viewDidLoad]; 

UIActionSheet ♦actionSheet = [nHAftionSheet alloc] 

initTOfctirit le:@"Vou lez-vous arrêter l'application ?" 

A delegate:self cancelButtonTitle;nil destructiveButtonTitle:nil 

otherButtonTitles:@"Oui", @"Non",<a"Je ne sais pas", nil] ; 
actionSheet.actionSheetStyle = UIActionSheetSty leBlackOpaque; 
actionSheet.destructiveButtonlndex = 1; 

[actionSheet showInView: self . view] ; 


Figure 11.9 - Xcode affiche un triangle de couleur jaune 
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1 # import <UIKit/UIKit.h> 

2 

3 ©interface ViewController : UlViewController < 

UIActionSheetDelegate > 

4 ©property (weak, nonatomic) IBOutlet UILabel ♦status; 

5 

6 ©end 

Le problème a disparu, comme par magie. 

Maintenant, il ne reste plus qu’à définir le code qui réagit aux clics sur les boutons de la 
boîte de dialogue modale. Cliquez sur ViewController .m dans le volet de navigation 
et ajoutez la méthode actionSheet : clickedButtonAtlndex dans le code : 

1 - ( vo id ) act i onSheet : ( UI Ac t ionShee t ♦) actionSheet 

clickedButtonAtlndex : (HSInteger) buttonlndex 

2 { 

3 if (buttonlndex == 0) 

4 status . text = ©"Vous avez cliqué sur Oui"; 

5 if (buttonlndex == 1) 

6 status . text = ©"Vous avez cliqué sur Mon"; 

7 if (buttonlndex == 2) 

8 status . text = ©"Vous avez cliqué sur Je ne sais pas"; 

9 } 

Cette méthode est appelée lorsqu’un bouton de la boîte de dialogue modale est pressé. 
Le NSInteger buttonlndex représente l’index du bouton pressé par l’utilisateur (0 si 
le premier bouton est pressé, 1 si le deuxième bouton est pressé, etc.). 

La méthode clickedButtonAtlndex se contente d’afficher un texte en rapport avec le 
bouton cliqué dans le contrôle Label. 

Vous trouverez à la suite le code de l’application. 


ViewController. h 

1 # import <UIKit/UIKit.h> 

2 

3 ©interface ViewController : UlViewController < 

UIActionSheetDelegate > 

4 ©property (weak, nonatomic) IBOutlet UILabel ♦status; 

5 

6 ©end 

ViewController.m 


1 #import "ViewController . h" 

2 

3 ©implémentation ViewController 

4 ©synthesize status; 

5 
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- ( void) didRecei veMemoryWarning 

{ 

[super didReceiveMemoryWarning] ; 

// Release any cached data, images , etc that aren ' t in use. 

} 

#pragma mark - View lifecycle 

- ( void) viewDidLoad 

{ 

[super viewDidLoad]; 

UI Act ionSheet *actionSheet = [ [UIActionSheet alloc] 

initWithTit le :©" Voulez - vous arrêter l'application ?" 
delegate : self cancelButtonTitle : nil des t ruct i veBut t onTit le : 
nil 

o therBut t onTit les : © " Oui " , ©"Non", ©"Je ne sais pas", nil]; 
act ionSheet . act ionSheet St y le = UI Act ionSheet St y leB lackûpaque ; 
act ionSheet . des t ruct i veBut t onlndex = 1; 

[actionSheet showInView : self . view] ; 

} 

- ( void) act ionSheet :( UI Act ionSheet ♦) actionSheet 

clickedButtonAtlndex : (NSInteger) buttonlndex 

{ 

if (buttonlndex == 0) 

status . text = 8"Vous avez cliqué sur Oui"; 
if (buttonlndex == 1) 

status . text = ©"Vous avez cliqué sur Non"; 
if (buttonlndex == 2) 

status . text = ©"Vous avez cliqué sur Je ne sais pas"; 

} 

- ( void) viewDidUnload 

{ 

[self setStatus :nil] ; 

[super viewDidUnload]; 

// Release any retained subviews of the main view. 

// e.g. self . myOut let = nil; 

} 

- (void) viewWill Appear : (B00L) animated 

{ 

[super viewWillAppear : animated] ; 

} 

- (void) viewDidAppear : (B00L) animated 

{ 

[super viewDidAppear : animated] ; 


} 
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- (void)viewWillDisappear:(BOOL) an i mat ed 

{ 

[super viewWillDisappear : animated] ; 

} 

- (void) viewDidDisappear : (B00L) animated 

{ 

[super viewDidDisappear : animated] ; 

} 

- (B00L) shouldAutorotateToInterfaceûrientation : ( 

UI Interface Orientât ion) interface Orientât ion 

{ 

// Return YES for supported orientations 
return ( inter f aceOrientat ion != 

UIInterfaceOrientationPortraitUpsideDown) ; 

} 

®end 


[ Copier ce code 
[Code web : 194709 

En résumé 


- Le contrôle Map View permet d’afficher une carte, comme dans l’application Maps 
d’Apple. En utilisant les méthodes de la classe MKMapView, vous pouvez, entre autres, 
centrer la carte sur une coordonnée spécifique, choisir la taille de la zone à afficher 
ou encore ajouter des informations personnalisées sur la carte. 

- Vous utiliserez un contrôle Scroll View pour afficher un contenu qui est plus grand 
que la fenêtre de l’application. Les utilisateurs pourront alors faire glisser la fenêtre 
de visualisation sur le contenu, mais aussi zoomer vers l’avant et vers l’arrière en 
pinçant /étirant l’écran avec deux doigts. 

- Il est parfois utile d’afficher une boîte de dialogue modale (c’est-à-dire qui se super- 
pose à la fenêtre de l’application et qui y interdit toute action) pour demander à 
l’utilisateur de prendre une décision. Par exemple, pour confirmer l’arrêt de l’appli- 
cation ou l’écrasement d’un fichier. Deux classes peuvent être utilisées à cet effet : 
UIAlertView et UIActionSheet. 
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Chapitre 



Les informations tabulaires 


Difficulté : — 

L es applications iOS ont souvent recours à des vues tabulaires pour présenter des listes 
de données. Ces listes permettent de : 

- présenter un ensemble d'options sélectionnables par l'utilisateur; 

- naviguer dans un ensemble de données structurées hiérarchiquement; 

- présenter une liste d'éléments triés selon un ou plusieurs critères; 

- définir plusieurs niveaux de détail pour faciliter l'affichage des informations sur des devices 
de petite taille. 

Ce chapitre va s'intéresser aux trois types de vues tabulaires utilisables sur un device : Table 
View, Picker View et Date Picker. Il va vous montrer comment afficher des contrôles 
tabulaires dans vos applications, comment les remplir et comment réagir aux actions des 
utilisateurs. 
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Xcode propose trois contrôles pour manipuler des informations tabulaires : Table View, 
Picker View et Date Picker : 

- le premier affiche des listes d’informations sur une colonne ; 

- le deuxième affiche des informations sur une ou plusieurs colonnes, sous la forme 
d’une roulette 3D ; 

- le troisième est très similaire au deuxième, à ceci près qu’il est spécialisé dans l’affi- 
chage des dates et d’heures. 

Nous allons voir comment les utiliser dans ce chapitre. 


Listes d’informations sur une colonne 

Les contrôles Table View sont utilisés pour afficher des listes d’informations sur une 
colonne. Plusieurs applications fournies avec votre device utilisent un contrôle Table 
View (figure 12.1). 
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Figure 12.1 - L’application Contacts utilise un Table View 

Les contrôles Table View peuvent être composés de zéro (même si cela n’offre pas 
beaucoup d’intérêt), une ou plusieurs sections. Chaque section peut : 

- comporter zéro, une ou plusieurs lignes ; 

- être précédée d’un en-tête de section ; 

- être suivie d’un pied de section. 

Les sections sont identifiées par leur numéro d’index dans le tableau : première section, 
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deuxième section, etc. Les lignes sont identifiées par leur numéro d’index dans une 
section : première ligne de la première section, deuxième ligne de la première section, 
etc. 

L’utilisateur peut se déplacer verticalement dans un contrôle Table View en utilisant 
une gestuelle de glisser. Lorsqu’il clique sur un des éléments listés, une vue détaillée 
de cet élément est affichée. La communication entre le contrôle Table View et les 
différentes vues détaillées se fait via un contrôle Table View Controller. 

Première approche 

Pour faciliter l’écriture d’une application basée sur l’utilisation d’un Table View et des 
vues détaillées correspondantes, le plus simple consiste à utiliser le modèle Master-Detail 
Application. 

Créez un nouveau projet basé sur le modèle Master-Detail Application, cliquez 
sur Next, donnez le nom « tableView » à l’application, choisissez le dossier de sau- 
vegarde et validez en cliquant sur Create. Une fois l’application créée, cliquez sur 
MainStoryboard. storyboard dans le volet de navigation. Comme vous pouvez le voir 
à la figure 12.2, un contrôleur de navigation, un contrôle Table View et une vue dé- 
taillée ont été insérés dans l’application. 


X 




X. 

\ 
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Detail 



Detail > 






O 
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Navigation Master Master I3et.nl - 


Figure 12.2 - Un contrôleur de navigation, un contrôle Table View et une vue détaillée 
ont été insérés dans l’application 

Exécutez l’application en cliquant sur Run. Le contrôle Table View est bien visible, 
mais il ne contient aucune donnée. Nous allons remédier à cette situation en définissant 
quelques données textuelles et en les reliant au contrôle Table View. 

La source de données peut provenir d’à peu près n’importe où : d’un tableau, d’un 
fichier XML ou d’une base de données par exemple. Pour que les choses soient aussi 
simples que possible, nous allons utiliser un tableau comme source de données. Cli- 
quez sur MasterViewController .h dans le volet de navigation et définissez l’objet 
NSMutableArray *maListe : 
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# import <UIKit/UIKit .h> 

©interface MasterViewController 

{ 

NSMutableArray ♦maListe ; 

} 

®end 


UITableViewController 


Maintenant, cliquez sur MasterViewController .m dans le volet de navigation. Pour 
que le tableau soit rempli dès le démarrage de l’application, nous allons ajouter quelques 
instructions dans la méthode viewDidLoad : 


1 

- 

(void) viewDidLoad 


2 

{ 




3 


[super viewDidLoad]; 


4 


maListe = 

[NSMutableArray array]; 

5 


[maListe 

addOb j ect : 0 

" Paris " ] ; 

6 


[maListe 

addOb j ect :® 

"Lyon"] ; 

7 


[maListe 

addOb j ect :® 

" Marseille " ] ; 

8 


[maListe 

addOb j ect :® 

" Toulouse " ] ; 

9 


[maListe 

addOb j ect :® 

" Nantes " ] ; 

10 


[maListe 

addOb j ect : 0 

"Nice"] ; 

11 


[maListe 

addOb j ect : 0 

" Bordeaux " ] ; 

12 


[maListe 

addOb j ect :® 

" Montpellier " ] ; 

13 


[maListe 

addOb j ect :® 

" Rennes " ] ; 

14 


[maListe 

addOb j ect :® 

"Lille"] ; 

15 


[maListe 

addOb j ect : 0 

"Le Havre"]; 

16 


[maListe 

addOb j ect :® 

" Reims"] ; 

17 


[maListe 

addOb j ect : 0 

"Le Mans " ] ; 

18 


[maListe 

addOb j ect :® 

"Dijon"] ; 

19 


[maListe 

addOb j ect :® 

"Grenoble"] ; 

20 


[maListe 

addOb j ect :® 

" Brest " ] ; 

21 


self . navi 

gationltem . 

title = ®"Grandes 

22 

> 





> 


L’instruction de la ligne 4 initialise l’objet maListe : 
l| maListe = [NSMutableArray array] ; 

Les instructions suivantes ajoutent des éléments dans maListe en appliquant la mé- 
thode addObject à l’objet maListe. Par exemple : 

l| [maListe addOb j ect : @ " Paris "] ; 

Enfin, la ligne 21 définit le titre qui sera affiché sur la première ligne du contrôle Table 
View : 

l| self . navigationltem . title = ^''Grandes villes"; 


Copier ce code 
Code web : 348581 
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Je sens que vous brûlez d’impatience de voir ces données affichées dans le Table View. 
Allez, cliquez sur Run. 


Oh consternation ! Le contrôle Table View est toujours vide ! Réfléchissez un peu. Tout 
ce qui a été fait jusqu’ici, c’est de créer un objet NSMutableArray. Comment le contrôle 
Table View pourrait-il supposer qu’il doit l’utiliser comme source de données? 

Pour cela, deux actions doivent être accomplies. Vous devez : 

1. indiquer au contrôle Table View combien de données il doit afficher; 

2. relier les objets Table View et maListe. 

Pour connaître le nombre d’éléments du tableau maListe, vous utiliserez l’instruction 
suivante : 

1 | [maListe count] ; 

La méthode prédéfinie numberOf RowsInSection retourne un entier qui correspond 
au nombre d’éléments à afficher dans le Table View. Par défaut, la valeur retour- 
née est égale à 0 : aucune information n’est donc affichée. En remplaçant le 0 à la 
suite de l’instruction return par le message [maListe count] , le contrôle Table View 
sait combien d’éléments il doit afficher. Définissez la méthode suivante dans le fichier 
MasterViewController .m : 

1 - ( NSInteger ) tableView :( UI Table View *) tableView 

numberOf Rows InSec t ion : (NSInteger) section 

2 { 

3 return [maListe count]; 

4 } 

Il ne reste plus qu’à relier le Table View au contrôle maListe. Cette étape se fera grâce 
à la méthode cellForRowAtlndexPath. Consultez la documentation Apple pour avoir 
une idée du contenu de cette méthode (figure 12.3). 

Les premières lignes (1) définissent un objet cell de classe UITableViewCell et le 
relient à une cellule du Table View. Nous les reprendrons telles quelles. 

Les dernières lignes (2) sont propres à l’exemple pris par Apple, nous allons donc les 
modifier. Dans le cas qui nous préoccupe, les cellules (cell . textLabel . text) doivent 
être reliées aux éléments du Table View ( [maListe objectAtlndex: ...]) dont l’in- 
dex correspond au numéro de ligne du Table View (indexPath.row). Voici le code 
complet de la méthode cellForRowAtlndexPath : 

1 - (UITableViewCell * ) tableView :( UITableView *) tableView 

cellForRowAtlndexPath : (NSIndexPath *) indexPath 

2 { 

3 static NSString * My Ident if ier = <3 " My Ident if ier " ; 

4 

5 UITableViewCell ♦cell = [tableView 

dequeueReusableCe HWi thl dent if ier : Myldentifier] ; 

6 
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return ( région. tunezonetrrappers count|; 


- (NSStrlng * (tabieviev: | uiTableviev • (tanloVlev tltlerorHeaderlnSectlon: (NSlnteger) section < 

// The neader t or the section la the région nante — get thla rro* the région at the section index. 
Région «région • (réglons objectAt index: section); 
return (région name); 

> 


- (UlTablevlewcell • (tableview: (UlTableview • (tableview celirorRowAtlndexrath: (NSlndexPath «jlndexPath < 
stetlc NSStrlng «Ryldenttf 1er - «’Myidentlf 1er’ ; 
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lf (cell •» nll) { 

cell • |i (UlTableviewcell allocj lnltmthStyle:uiTableviewcellstyleüefault 
reuse identlfler:Myx dent 1 ( 1er ] autor e 1 ease ( ; 

> 

Région «région • (réglons objectAt Index :lndexPath. section); 

Tlmezonewrapper «timezonetcrapper ■ | région . tlnezonewrappers objectât index UndexPath.rov); 
cell.texttabel.text • tlnezoneKrapper . localename; 
return cell; 

} 


0 


0 


The data source in its implémentation of the tableViewîcellForRovAt IndexPath: method returns a configured cell 
object thaï the table view can use to draw a row. For performance reasons. the data source tries to reuse cells as much as 
possible. It first asks the table view for a spécifie reusable cell object by sending it 

dequeueReusableCellWithldentif ier : . message, if no such object exists. the data source créâtes It. asslgning it a 


Figure 12.3 - La documentation 
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if ( cell == nil ) 

cell = [ [UITableViewCell alloc] initWithStyle : 

UITableViewCellStyleDef ault reuseldentif ier : Myldentifier 

] ; 

// Configuration de la cellule 

NSString *cellValue = [maListe ob j ect At Index : indexPat h . r ou] ; 
cell . textLabel . text = cellValue; 
return cell ; 


(Copier ce 

code 


(Code web 

: 553565 

J 


Les lignes 1 à 8 ainsi que la ligne 13 sont issues de l’aide Apple. La ligne 11 définit 
l’objet cellValue de classe NSString (NSString *cellValue) et y stocke l’élément du 
tableau maListe ([maListe . . .) qui se trouve à la ligne (objectAtlndex) courante 
(indexPath.row] ). 

l| NSString ♦cellValue = [maListe obj ect At Index : indexPath . row] ; 

La ligne 12 affecte la valeur obtenue à la ligne précédente à la cellule : 
l| cell . textLabel . text = cellValue; 

Avant de cliquer sur Run, vous devez encore dire à Xcode que les données à afficher 
dans le Table View seront définies dans l’application. Comme à la figure 12.4, cliquez 
sur MainStoryboard. storyboard dans le volet de navigation (1), cliquez sur Table 
View dans la zone d’édition (2), sur l’icône Hide or show the Utilities (3) puis sur 
l’icône Show the Attributes inspector (4). Choisissez enfin Dynamic Prototypes 
dans la liste déroulante Content (5). 

Maintenant, vous pouvez cliquer sur Run. La fenêtre du simulateur iOS devrait afficher 
quelque chose ressemblant à la figure 12.5. 

Une dernière petite chose. Avez-vous remarqué le point d’exclamation dans la partie 
supérieure de la fenêtre de Xcode? Si vous cliquez dessus, un message d’erreur vous 
indique ce qui ne va pas. Ce dernier indique « Prototype table cells must hâve reuse 
identifters », soit en bon français « Le prototype des cellules du tableau doit avoir un 
identifiant ». 

Comme indiqué à la figure 12.6, cliquez sur le prototype des cellules dans la vue Master 
(1), sur l’icône Show the Attributes inspector dans le volet des utilitaires (2), puis 
définissez un identifiant dans la zone de texte Identifier (3). 
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Figure 12.4 - Les données doivent être définies dans l’application 



Figure 12.5 - Les données apparaissent dans l’application 
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Figure 12.6 - Définissez un identifiant dans la zone de texte Identifier 


Utilisation de la vue détaillée 

Les contrôles Table View sont généralement utilisés avec une vue secondaire qui donne 
des détails sur l’élément sélectionné par l’utilisateur dans la liste. Nous allons voir 
comment utiliser cette vue dans l’application précédente. Rappelez-vous : lors de la 
création de l’application tableView, une vue détaillée a été ajoutée au canevas (figure 
12.7). Reste donc à voir comment l’utiliser. 

En observant cette figure, je vois que la vue Master n'est pas reliée à la vue 
Detail. Et pourtant, elle l'était tout à l'heure. Que s'est-il passé? 

Effectivement, ces deux vues étaient reliées, mais lorsque vous avez sélectionné Dynamic 
Prototypes dans la propriété Content de la vue Master, le lien a été brisé. Qu’à cela 
ne tienne, nous allons le recréer ! 

Si ce n’est pas déjà fait, affichez le canevas en cliquant sur MainStoryboard . storyboard 
dans le volet de navigation. Ensuite, comme indiqué à la figure 12.8, cliquez sur l’élé- 
ment qui représente une cellule dans la vue Master (1) puis contrôle-glissez-déposez 
cet élément sur la vue Detail (2). Au relâchement du bouton gauche de la souris, 
sélectionnez Push. dans le menu (3). 
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Navigation Controller 


Detail View Controller - Detail 


Figure 12.7 - Une vue détaillée a été ajoutée au canevas 




Master 

Prototype Cells 




"■DI 

Table View 




Detail View Controller - Detail 


Detail View Controller - Detail 


Figure 12.8 - Il faut relier la vue Master à la vue Detail 
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La liaison entre les vues Master et Detail est maintenant rétablie (figure 12.9). 



Figure 12.9 - La liaison entre les vues Master et Detail est maintenant rétablie 


Pour pouvoir y faire référence dans le code, vous allez lui donner un nom. Comme 
indiqué sur la figure 12.10, cliquez sur le symbole qui identifie la liaison dans le ca- 
nevas (1), sur l’icône Hide or show the Utilities dans la barre d’outils (2), sur 
Show the Attributes inspector dans le volet des utilitaires (3) puis donnez le nom 
« detailSegue » à la liaison (4). 
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Figure 12.10 - Il faut donner un nom à la liaison pour pouvoir y faire référence 
Vous allez maintenant insérer un contrôle Label dans la vue Detail. Ce contrôle sera 
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utilisé pour afficher des informations en relation avec l’élément sélectionné par l’utili- 
sateur dans la vue Master. 

Une fois le contrôle Label inséré dans la vue Detail, associez-lui l’outlet donneeRecue 
pour qu’il soit accessible dans le code. 

Je pense que cette opération doit maintenant être habituelle pour vous, mais à tout 
hasard, je vais faire un rappel. Pour définir l’outlet unMessage pour le contrôle Label : 

1. dans la barre d’outils de Xcode, au-dessus du libellé Editor, cliquez sur l’icône 
Show the Assistant editor; 

2. contrôle-glissez-déposez le contrôle Label dans le fichier d’en-têtes, juste au- 
dessus du Send final ; 

3. au relâchement du bouton gauche de la souris, donnez le nom « donneeRecue » 
à l’outlet et validez en cliquant sur Connect. 


Le code du fichier d’en-têtes doit maintenant ressembler à ceci : 


î 

2 

3 

4 

5 

6 

7 


# import CUIKit/UIKit .h> 

Sinterface DetailViewController : UlViewController 

Sproperty (strong, nonatomic) id detailltem; 

Sproperty (strong, nonatomic) IBOutlet UILabel * 
detailDescriptionLabel ; 

(Sproperty (weak, nonatomic) IBOutlet UILabel ♦donneeRecue; 


9 Send 


Lorsque l’utilisateur sélectionne un élément dans le contrôle Table View, la vue Detail 
remplace la vue Master. Pour passer des informations de la vue Master à la vue Detail, 
Apple préconise d’utiliser la méthode prepareForSegue. Malheureusement, il n’est pas 
possible d’atteindre directement le label donneeRecue, vous devez passer par une va- 
riable intermédiaire. Cliquez sur DetailViewController .h dans le volet de navigation 
et définissez la propriété texteAAf ficher comme suit : 

l| Sproperty (strong, nonatomic) id t ext e AAf f icher ; 

Le fichier DetailViewController .h doit maintenant contenir les instructions sui- 
vantes : 

1 # import <UIKit/UIKit.h> 

2 

3 ^interface DetailViewController : UlViewController 

4 

5 Sproperty (strong, nonatomic) id texte AAf f icher ; 

6 (Sproperty (strong, nonatomic) id detailltem; 

7 (Sproperty (strong, nonatomic) IBOutlet UILabel * 

detailDescriptionLabel ; 

8 Sproperty (weak, nonatomic) IBOutlet UILabel * donneeRecue ; 

9 Send 
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Cliquez sur DetailViewController .m dans le volet de navigation et ajoutez une ins- 
truction synthesize pour pouvoir accéder à la propriété texteAAf ficher : 

l| ©synthesize texte A Af f i cher = _t ext e A Af f icher ; 

Ça y est, tout est en place pour insérer la méthode prepareForSegue. Cliquez sur 
MasterViewController .m dans le volet de navigation et insérez les instructions sui- 
vantes dans le code (peu importe l’endroit) : 

1 -( void ) prepareForSegue :( UI St oryboardSegue *) segue sender : ( id) 

sender { 

2 if([[segue identifier] isEqualToSt ring detail Segue "] ) 

3 { 

4 NSInteger selectedlndex = [ [self . tableView 

indexPat hFor Sele et edRow] row]; 

5 DetailViewController *dvc = [segue 

de s t inat ionViewCont r o lier ] ; 

6 dvc . texte AAf f i cher = [NSString s t r ingWithFormat , [ 

maListe objectAtlndex: selectedlndex]] ; 

7 } 

8 } 

Ne soyez pas impressionnés par l’apparente complexité du code : l’autocomplétion est 
votre amie. Ainsi par exemple, lorsque vous commencez à écrire les premières lettres 
de la méthode prepareForSegue, une bulle s’affiche sur l’écran, comme à la figure 
12.11. Appuyez simplement sur la touche | Entrée ) pour recopier le texte proposé par 
l’autocomplétion. 

-(void)prepareForSegue: ( UlStoryboardSegue *)segue sender: ( id)sender 


M prepareForSegue: (UlStoryboardSegue *)segue sender: (id)sender 


Figure 12.11 - Xcode propose l’autocomplétion 

La ligne 2 teste si l’identifiant de la transition entre la vue Master et la vue Detail a 
bien pour nom « detailSegue » : 

l| if ([[segue identifier] isEqualToS t r ing : @ " de t ailSegue " ] ) 

Rappelez-vous, ce nom a été défini un peu plus tôt. Et maintenant, vous 
l'utilisez dans le code. 

La ligne 4 définit le NSInteger selectedlndex et l’initialise avec l’index de la cellule 
choisie par l’utilisateur (indexPathForSelectedRow) du contrôle TableView de la vue 
Master (self .tableView) : 

1 NSInteger selectedlndex = [ [self . tableView 

indexPathForSelectedRow] row]; 

selectedlndex vaudra 0 si l’utilisateur a choisi le premier élément. Il vaudra 1 s’il a 
choisi le deuxième élément. Ainsi de suite. . . 
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Maintenant, nous connaissons l’index de la cellule choisie par l’utilisateur. Encore faut- 
il accéder au Label de la vue Detail. Pour cela, la ligne 5 définit l’objet dvc de classe 
DetailViewController (DetailViewController *dvc) et l’initialise avec la vue qui 
va être affichée ([segue destinationViewController] ) : 

l| DetailViewController ♦dvc = [segue destinationViewController]; 

Il ne reste plus qu’à affecter le contenu de la cellule à la propriété texteAAf ficher. 
C’est précisément ce que fait la ligne 6. La propriété texteAAf ficher est initialisée 
avec l’élément du tableau maListe d’index selectedlndex. Cet objet est converti en 
un NSString avant d’être stocké dans la propriété texteAAf ficher : 

1 dvc . t ext e A Af f icher = [HSString s t r ingWithFormat : @ " */, 0 " , [maListe 
objectAtlndex: selectedlndex]] ; 



Mais au fait, comment le code de la vue Master va-t-il pouvoir accéder au 
code de la vue Detail ? 


Vous devez ajouter une instruction import au début du fichier MasterViewController .m, 
sans quoi Master n’arrivera pas à « dialoguer » avec Detail et plusieurs erreurs appa- 
raîtront dans le code : 

l| # import "DetailViewController. h" 

Après tous ces efforts, vous devez certainement être impatients de lancer l’application. 
Vous pouvez toujours le faire, mais je suis assez pessimiste quant au résultat obtenu : il 
est vrai que la vue Master a indiqué à la vue Detail quelle était la cellule sélectionnée 
par l’utilisateur. Mais rappelez-vous, cette indication a été fournie dans la propriété 
texteAAf ficher et non dans le Label donneeRecue. Vous allez donc devoir agir sur 
le code de la vue Detail. Cliquez sur DetailViewController .m et ajoutez la ligne 6 
à la méthode viewDidLoad : 

1 - (void) viewDidLoad 

2 { 

3 [super viewDidLoad]; 

4 // Do any additional setup after loading the view, typically 

f rom a nib . 

5 [self c onf igure View ] ; 

6 .donneeRecue . text = _t ext e A Af f icher ; 

7 } 

Cette ligne recopie simplement le contenu de la propriété texteAAf ficher dans le 
Label. 

Ça y est, vous pouvez lancer l’application et profiter du passage de données entre les 
vues Master et Detail. La figure 12.12 représente par exemple ce que vous devriez 
obtenir si vous choisissez « Toulouse » dans la vue Master. 

Le code web suivant vous permet de copier les codes de l’application. 
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I Paris 
Lyon 
Marseille 


Toulouse 


Nantes 
Nice 
Bordeaux 
Montpellier 
Rennes 



Toulouse 



□ 

1 1 

1 



L A 


Figure 12.12 - « Toulouse » est sélectionné dans la vue Master 


> 


Copier ce code 
^Code web : 170881 


Listes d’informations sur une ou plusieurs colonnes 


Les contrôles Table View ont une variante : les Picker View. Outre leur aspect « rou- 
lette 3D », ces contrôles peuvent afficher des informations sur une ou plusieurs colonnes, 
et chaque colonne peut comporter un nombre d’informations différent. 

Pour effectuer une sélection, l’utilisateur tourne la ou les roues (figure 12.13) jusqu’à 
ce que la ou les valeurs affichées se trouvent sous la marque de sélection. Les valeurs 
sélectionnées sont obtenues avec la méthode pickerView:didSelectRow: inComponent. 



Sunnyvale 
Cupertino 
Santa Clara 


San José 



Figure 12.13 - L’utilisateur utilise des « roulettes 3D » pour faire une sélection 

Ces contrôles relèvent de la classe UlPickerView. Pour illustrer leur fonctionnement, 
nous allons définir une application dans laquelle l’utilisateur pourra sélectionner une 
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entrée dans un contrôle Picker View. Cette dernière sera alors affichée dans un contrôle 
Label. 

Définissez une nouvelle application basée sur le modèle Single View Application et 
donnez-lui le nom « picker ». En utilisant Interface Builder, ajoutez un contrôle Picker 
View et un contrôle Label au fichier MainStoryboard. storyboard. Double-cliquez sur 
le contrôle Label et tapez « Choisissez une ville ». L’interface de l’application doit 
maintenant ressembler à la figure 12.14. 


Mountain View 

Sunnyvale 

I - Cupertino 
Santa Clara 

San José 

Choisissez une ville 




Figure 12.14 - L’interface de l’application 


Reliez les deux contrôles de l’interface au code en les contrôle-glissant-déposant depuis 
la zone d’édition dans le fichier ViewController .h. Définissez un outlet pour le contrôle 
Picker View et donnez-lui le nom pv. Définissez un outlet pour le contrôle Label et 
donnez-lui le nom status. Le fichier ViewController .h doit maintenant ressembler à 
ceci : 


î 

2 

3 

4 

5 

6 
7 


# import CUIKit/UIKit .h> 

Sinterface ViewController : 
Oproperty (weak , nonatomic) 
Oproperty (weak, nonatomic) 


UlViewController 
IBOutlet UlView *pv; 
IBOutlet UILabel ♦status ; 


®end 
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Pour utiliser un contrôle Picker View, il est nécessaire d’implémenter les protocoles 
UIPickerViewDelegate (traitement des actions de l’utilisateur dans le Picker View) 
et UIPickerViewDataSource (données utilisées dans le Picker View). 



Mais au fait, qu'est-ce que ça veut dire « implémenter un protocole » ? J'ai 
un trou de mémoire ! 


Dans le jargon Objective-C, un protocole consiste en une liste de déclarations de mé- 
thodes. Lorsqu’une classe implémente un protocole, cela signifie qu’elle peut appeler 
les méthodes qui sont définies dans ce protocole. Supposons par exemple que la classe 
Voiture, sous-classe de Véhiculé, implémente le protocole Moteur. Pour le signifier à 
Xcode, vous devrez modifier l’instruction Ointerface. 


^interface Voiture 


Véhiculé { 


Comme ceci : 


1 

2 

3 


©interface Voiture 


} 


Véhiculé <Moteur>{ 


Ici, la classe ViewController, sous-classe de UlViewController, doit implémenter 
les protocoles UIPickerViewDelegate et UIPickerViewDataSource. La déclaration 
de l’interface : 


^interface ViewController 


UlViewController { 


doit donc être modifiée comme suit : 


î 


©interface ViewController : UlViewController < 

UIPickerViewDelegate, UIPickerViewDataSource > { 


} 


Si ceci n’est pas clair, relisez calmement les quelques phrases qui précèdent. Vous verrez, 
il n’y a rien de sorcier ! 

Les données affichées dans le contrôle Picker View vont être stockées dans un tableau 
que nous appellerons maListe. Vous devez définir ce tableau dans le fichier d’en-têtes, 
qui devrait maintenant ressembler à ceci : 


î 

2 

3 

4 

5 


# import CUIKit/UIKit .h> 

©interface ViewController : UlViewController < 

UIPickerViewDelegate , UIPickerViewDataSource > 

{ 


NSMutableArray *maListe; 
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6 } 

7 

8 Sproperty (weak , nonatomic) IBOutlet UlView *pv; 

9 Sproperty (weak, nonatomic) IBOutlet UILabel ♦status; 

10 

11 @end 

L’alimentation et la gestion du contrôle Picker View seront réalisées dans le code de 
l’application (ViewController .m). Pour l’indiquer à Xcode, il suffit de relier les outlets 
dataSource et delegate du Picker View au File’ s Owner (figure 12.15). 

1. Cliquez sur MainStoryboard. storyboard dans le volet de navigation (1). 

2. Cliquez sur le contrôle Picker View dans le volet de navigation (2). 

3. Affichez le volet des utilitaires en cliquant sur l’icône Hide or show the Utilities 
(3). 

4. Cliquez sur Show the Connections inspector dans le volet des utilitaires (4). 

5. Sous Outlets, reliez le cercle qui se trouve à droite de dataSource à l’icône View 
Controller (5). 

6. Toujours sous Outlets, reliez le cercle qui se trouve à droite de delegate à l’icône 
View Controller (6). 



Figure 12.15 - Il faut relier les outlets dataSource et delegate du Picker View au 
File’ s Owner 

Il est temps de modifier le fichier .m. Cliquez sur ViewController .m dans le volet de 
navigation. 
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Le tableau sera initialisé dans la méthode viewDidLoad : 

(void) viewDidLoad 


1 

2 

3 

4 

5 

6 

7 

8 
9 

10 

11 

12 

13 

14 

15 

16 

17 

18 

19 

20 
21 


[super viewDidLoad]; 
maListe = [[NSMutable 
[maListe addObject 
[maListe addObject 
[maListe addObject 
[maListe addObject 
[maListe addObject 
[maListe addObject 
[maListe addObject 
[maListe addObject 
[maListe addObject 
[maListe addObject 
[maListe addObject 
[maListe addObject 
[maListe addObject 
[maListe addObject 
[maListe addObject 
[maListe addObject 


Array alloc] init]; 
Paris " ] ; 

Lyon"] ; 

Marseille "] ; 
Toulouse " ] ; 

Nantes " ] ; 

Nice " ] ; 

Bordeaux " ] ; 
Montpellier " ] ; 
Rennes " ] ; 

Lille"] ; 

Le Havre " ] ; 

Reims " ] ; 

Le Mans"] ; 

Dijon"] ; 

Grenoble " ] ; 

Brest " ] ; 


f Copier ce code 

[ Code web : 156087 y 

Il n’y a rien de bien compliqué dans ces instructions. L’objet maListe est instancié : 
l| maListe = [ [NSMutableArray alloc] init]; 

Puis plusieurs valeurs sont mémorisées dans le tableau à l’aide de la méthode addûbj ect : 
l| [maListe addObj ect : @ " Paris "] ; 

Nous allons maintenant mettre en place les méthodes qui vont « alimenter » le contrôle 
Picker View : 

1 - ( NSInt eger ) number Of Component s InPi ckerView : ( UlPickerView * ) 

pickerView { 

2 return 1 ; 

3 } 

4 - ( NSInt eger ) p i ckerView :( UIPi ckerView *) pickerView 

numberOf RowslnComponent : (NSInteger) component { 

5 return [maListe count] ; 

6 } 

7 - (NSString *) pickerView : (UlPickerView *) pickerView titleForRow 

:( NSInteger ) row f orComponent :( NSInt eger ) component { 

8 return [maListe obj ect At Index : row] ; 

9 } 


Copier ce code 

i 

v Code web : 163348 

V 
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La valeur retournée par la méthode numberOfComponentsInPickerView définit le nombre 
de colonnes dans le Picker View. Ici, une seule colonne : 

1 | return 1 ; 

La valeur retournée par la méthode numberOfRowslnComponent définit le nombre d’élé- 
ments affichés dans le Picker View. En ce qui nous concerne, ce nombre est égal au 
nombre d’éléments stockés dans le tableau maListe : 

1 | return [maListe count] ; 

Enfin, la valeur retournée par la méthode titleForRow est affectée à l’élément d’index 
row. Il suffit de l’extraire du tableau maListe via la méthode objectAtlndex : 

l| return [maListe ob j e et At Index : row] ; 

Pour terminer, nous allons définir la méthode qui va mettre à jour le Label lorsqu’un 
élément du Picker View sera sélectionné : 

1 - ( void ) pickerView : ( UlPickerView *) pickerView didSelectRow : ( 

NSInteger ) row 

2 inComponent : (NSInteger) componentl 

3 status . text = [maListe ob j e et At Index : row ] ; 

4 } 

Lorsque l’utilisateur clique sur une entrée, le NSInteger row contient l’index de cette 
entrée. Pour retrouver la valeur correspondante, il suffit donc de la lire dans le tableau 
maListe ([maListe objectAtlndex: row]). Cette valeur est alors copiée dans la com- 
posante text du Label (status. text =). En d’autres termes, elle est affichée dans le 
Label. 

Vous pouvez copier le code de l’application en utilisant le code web suivant. 


Copier ce code 

\ 

v Code web : 337610 

J 


ViewController.h 


1 

2 

3 

4 

5 

6 

7 

8 
9 

10 

11 


# import CUIKit/UIKit .h> 

©interface ViewController : UlViewController < 

UIPickerViewDelegate , UIPickerViewDataSource > 

{ 

NSMutableArray *maListe; 

} 

©property (weak , nonatomic) IBOutlet UlView *pv; 
©property (weak, nonatomic) IBOutlet UILabel ♦status; 

©end 


ViewController. m 
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#import " V iewC ont r oller . h" 

@ implement at i on ViewController 
(Ssynthesize pv ; 

Osynthesize status; 

- ( vo id ) didRe cei veMemory Warning 

{ 

[super didReceiveMemoryWarning] ; 

// Release any cached data, images, etc that aren't in use. 

} 


#pragma mark - View lifecycle 


(void) viewDidLoad 
[super viewDidLoad]; 

maListe = [ [NSMutableArray alloc] init] 


[maListe addObject 
[maListe addObject 
[maListe addObject 
[maListe addObject 
[maListe addObject 
[maListe addObject 
[maListe addObject 
[maListe addObject 
[maListe addObject 
[maListe addObject 
[maListe addObject 
[maListe addObject 
[maListe addObject 
[maListe addObject 
[maListe addObject 
[maListe addObject 


5 " Par i s " ] ; 

3 " Ly on " ] ; 

3 " Marseille " ] ; 

3 " Toulouse " ] ; 

3 "Nantes " ] ; 

3 " Nice " ] ; 

3 " Bordeaux " ] ; 
3"Montpellier "] ; 
3 " Rennes " ] ; 

3 "Lille"] ; 

3 "Le Havre"] ; 

3 " Reims " ] ; 

3 "Le Mans " ] ; 

3 " Di j on " ] ; 

3 " Grenoble " ] ; 

3 "Brest "] ; 


- ( NSInt eger ) number Of Component s InPi ckerView : ( UlPickerView *) 
pickerView { 
return 1 ; 

} 


- ( NSInt eger ) p i ckerView :( UIPi ckerView *) pickerView 

numberOf RowslnComponent : (NSInteger) component { 
return [maListe count] ; 

} 

- (NSString *) pickerView : (UlPickerView *) pickerView titleForRow 

:( NSInteger ) row f orComponent :( NSInt eger ) component { 
return [maListe obj ect At Index : row] ; 

} 
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-( void ) pickerView :( UlPickerView *) pickerView didSelectRow : ( 
NSInteger ) row 

inComponent : (NSInteger) component{ 

status . text = [maListe ob j e et At Index : row ] ; 

} 

- ( void) viewDidUnload 

{ 

[self setPv:nil]; 

[self setStatus :nil] ; 

[super viewDidUnload]; 

// Release any retained subviews of the main view . 

// e.g. self . myOut let = nil ; 

} 

- (void) viewWill Appear : (B00L) animated 

{ 

[super viewWillAppear : animated] ; 

} 

- (void) viewDidAppear : (B00L) animated 

{ 

[super viewDidAppear : animated] ; 

} 

- (void) viewWillDis appear : (B00L) animated 

{ 

[super viewWillDisappear : animated] ; 

} 

- (void) viewDidDisappear : (B00L) animated 

{ 

[super viewDidDisappear : animated] ; 

} 

- (B00L) shouldAutorotateTo Interface Orientât ion : ( 

UlInterfaceOrientation) interf aceûrientation 

{ 

// Return YES for supported orientations 
return ( int erf ace Or ient at i on ! = 

UIInterfaceOrientationPortraitUpsideDown) ; 

} 


®end 


élection 


d’une date dans un contrôle spécialisé 


contrôle Date Picker est très proche du contrôle Picker View, à ceci près qu’il est 
icialisé dans la sélection de dates et d’heures. Sa mise en œuvre est également plus 


SÉLECTION D’UNE DATE DANS UN CONTRÔLE SPÉCIALISÉ 


simple que celle d’un Picker View. 

À titre d’exemple, nous allons définir une application qui permettra à l’utilisateur de 
sélectionner une date et une heure dans un contrôle Date Picker. Un clic sur le bouton 
Sélectionner provoquera l’affichage de la sélection dans un contrôle Label, comme à 
la figure 12.16. 




Figure 12.16 - Voici à quoi ressemblera notre application 

Rien de très original me direz- vous ! Cependant, cette petite application va aborder les 
points essentiels concernant le contrôle Date Picker. Allez, retroussez vos manches ! 

Définissez une nouvelle application basée sur le modèle Single View Application et 
donnez-lui le nom « datePicker ». Sélectionnez le fichier MainStoryboard. storyboard 
et ajoutez-y un contrôle Date Picker, un contrôle Round Rect Button et un contrôle 
Label en utilisant Interface Builder. Double-cliquez sur le bouton et tapez « Sélec- 
tionner ». Double-cliquez sur le Label et tapez « Choisissez une date » puis appuyez 
sur Sélectionner. Enfin, positionnez ces trois contrôles pour obtenir quelque chose 
s’approchant de la figure 12.17. 

Cliquez sur l’icône Show the Assistant editor dans la barre d’outils de Xcode et 
définissez les outlets et actions suivants : 


Contrôle 

Outlet ou Action 

Nom 

UIDatePicker 

Outlet 

dp 

UILabel 

Outlet 

status 

UIButton 

Action 

sélectionner 
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Figure 12.17 - Positionnez les contrôles comme ceci 
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Le fichier ViewController .h doit maintenant ressembler à ceci : 

1 # import <UIKit/UIKit.h> 

2 

3 ©interface ViewController : UlViewController 

4 

5 ©property (weak , nonatomic) IBOutlet UIDatePicker * dp ; 

6 ©property (weak, nonatomic) IBOutlet UILabel *status; 

7 - ( IB Act i on ) select ionner :( id) sender ; 

8 ©end 

Rien de bien méchant là-dedans. Maintenant, vous devez être habitués à définir des 
interfaces avec Interface Builder et à référencer les contrôles dans le code en les contrôle- 
glissant-déposant depuis la zone d’édition sur le fichier d’en-têtes. 

Si vous le souhaitez, vous pouvez dès à présent lancer l’application en cliquant sur Run. 
Le contrôle Date Picker est opérationnel, même si aucune instruction n’a encore été 
écrite dans le fichier . m. 



Il se peut que le contrôle Date Picker affiche la date au format américain. 
Pour régler ce problème, lancez l'application Settings dans le simulateur, cli- 
quez sur Général, puis sur International. Réglez Language sur Français 
et Format régional sur France. 


Pour terminer l’application, nous allons donner vie au bouton en écrivant quelques 
lignes de code. Cliquez sur datePickerViewController .m dans le volet de navigation 
et complétez la méthode sélectionner comme suit : 

1 - ( IB Act i on ) select ionner :( id) sender { 

2 NSLocale *frLocale = [[NSLocale alloc] 

initWithLocaleldentifier :@"fr_FR"] ; 

3 NSDate *pickerDate = [dp date]; 

4 HSString *select = [[NSString alloc] initWithFormat :©"'/,©" , [ 

pickerDate des cr ipt i onWit hLo cale :frLocale]] ; 

5 status . text = select ; 

6 } 

Examinons ces instructions. Dans un premier temps, l’objet f rLocale de type NSLocale 
est défini (NSLocale *f rLocale = [[[NSLocale alloc] . . .) puis initialisé avec les 
paramètres régionaux fr_FR (initWithLocaleldentif ier : @"f r_FR") : 

1 NSLocale *frLocale = [[NSLocale alloc] initWithLocaleldentifier 
: © " f r _FR " ] ; 

Cet objet sera utilisé par la suite pour définir le format de la date et de l’heure à 
afficher dans le Label. Ici, nous avons utilisé le format fr_FR pour que les dates et 
heures soient affichées « à la française » . 

Pour faciliter l’écriture, l’objet NSDate pickerDate est défini et initialisé avec la date 
sélectionnée par l’utilisateur dans le contrôle Date Picker : 

1 I NSDate *pickerDate = [dp date] ; 
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L’instruction suivante définit l’objet select de classe NSString et l’initialise avec la 
date sélectionnée par l’utilisateur (pickerDate) mise en forme selon les conventions 
françaises (descriptionWithLocale :frLocale) : 

I NSString ♦select = [[NSString alloc] ini tWithFormat : @ , [ 

pickerDate descriptionWithLocale : frLocale] ] ; 

Enfin, la date et l’heure mémorisées dans l’objet select sont affectées à la composante 
text du Label, et donc, affichées dans le Label : 

l| status. text = select; 

II faut bien l’avouer, la mise en œuvre d’un contrôle Date Picker est vraiment simple ! 


En résumé 

- Les contrôles Table View sont utilisés pour afficher des listes d’informations sur 
une colonne. Pour faciliter l’écriture d’une application basée sur l’utilisation d’un 
Table View et des vues détaillées correspondantes, le plus simple consiste à utiliser 
le modèle Master-Detail Application. 

- Pour relier les éléments de la vue Master à la vue Detail, il suffit de créer un Segue 
(Push, Modal ou Custom) en contrôle- glissant-déposant une cellule de la vue Master 
sur la vue Detail dans le canevas. 

- Les contrôles Table View ont une variante : les Picker View. Outre leur aspect 
« roulette 3D », ces contrôles peuvent afficher des informations sur une ou plusieurs 
colonnes, et chaque colonne peut comporter un nombre d’informations différent. 

- Le contrôle Date Picker est très proche du contrôle Picker View, à ceci près qu’il 
est spécialisé dans la sélection de dates et d’heures. Sa mise en œuvre est également 
plus simple que celle d’un Picker View. 
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Les contrôles d'action 


Difficulté : or 

C omme leur nom le laisse supposer, les contrôles d'action sont utilisés pour effectuer 
des actions lorsque l'utilisateur interagit avec l'écran de son device. 

Dans cette section, vous allez apprendre à relier un contrôle d'action (bouton de commande, 
slider, zone de texte modifiable, etc.) au code de l'application afin de gérer un événement 
utilisateur. Si nécessaire, vous pourrez même créer plusieurs liaisons pour gérer plusieurs 
types d'actions. La technique est la même, seul le code à exécuter change. 

C'est (entre autres) en choisissant soigneusement les contrôles d'action utilisés qu'une 
application sera intuitive, agréable et facile à utiliser. Tournez vites les pages et découvrez 
les contrôles d'action utilisables sur un device iOS 5. 
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Boutons 

Les boutons sont les contrôles d’action de base. Leur apparence peut être personna- 
lisée en utilisant Interface Builder ou des instructions Objective-C. Vous pouvez par 
exemple choisir la forme, le texte, l’image, la couleur d’arrière-plan et encore beau- 
coup d’autres caractéristiques. Interface Builder donne accès à cinq types de boutons 
prédéfinis, comme le montre la figure 13.1. 


© Rounded Rect 


Figure 13.1 - Les cinq boutons prédéfinis par Interface Builder 

Pour transformer un bouton par défaut (Rounded Rect) en un bouton prédéfini, il 
suffit de faire votre choix dans la liste déroulante Type, comme indiqué à la figure 13.2. 




Width Height 

O Reverses On Highlight 


Highlight Tint 
Drawing 


Default 


O Shows Touch On Highlight 
0 Highlighted Adjusts Image 
0 Disabled Adjusts Image 


Line Break Truncate Middle 


Edge | Content 
Inset 


I i?BI 5B 

Top Bottom 

“B 1 °0 

Left Right 


Figure 13.2 - Vous pouvez faire votre choix dans la liste déroulante Type 



Pour ceux qui ne sauraient pas encore comment accéder aux propriétés : 
cliquez sur l'icône Hide or show the Utilities dans la barre d'outils, puis 
sur l'icône Show the Attributes inspector dans le volet des utilitaires. 


Il est également possible d’ajouter une image à un bouton Rounded Rect : insérez une 
image de petite taille dans les ressources de l’application et sélectionnez-la dans la 
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propriété Image du bouton. Si nécessaire, complétez cette image avec un texte, comme 
à la figure 13.3. 


Type | Rounded Rect 


State Config 
Title 
Image 
Background 
Font 
Text Color 
Shadow Color 


Default 


Rounded Rect avec image 


Ico.png 


Default Background Imaçjj 

System Bold 15.0 M|@ 




Default 


Default 


Shadow Offset 


^0 


Width Height 

|_J Reverses On Highlight 




Highlight Tint 
Drawing 


Default 


I) 


1_J Shows Touch On Highlight 
\j$ Highlighted Adjusts Image 
1^ Disabled Adjusts Image 


Line Break Truncate Middle 


Edge | 
Inset 


Top 


o'0 o'0 


o]0 


Right 


o!0 


Figure 13.3 - Il est possible d’ajouter une image en plus du texte à un bouton 



Si les boutons prédéfinis ne vous conviennent pas, il est possible de définir vos 
propres boutons « à la main ». Affichez le volet des attributs puis choisissez 
Custom dans la propriété Type du bouton. Vous pouvez alors choisir l'image, 
le texte et ses caractéristiques ainsi que l'arrière-plan du bouton. 


Enfin, il est également possible de créer un bouton en utilisant du code Objective-C : 

1 UIButton ♦monBouton = [UIButton but t onWi thType : 

UIBut t onType Inf oDark ]; 

2 [monBouton setCenter : CGPointMake ( 100 . Of , 100.0f)] ; 

3 [self. view addSubview : monBouton]; 

La première instruction définit l’objet monBouton, le rattache à la classe UIButton et 
définit son type UIButtonTypelnf oDark. La deuxième instruction définit les coordon- 
nées du centre du bouton. Le premier nombre correspond à l’abscisse et le deuxième 
à l’ordonnée, par rapport au coin supérieur gauche de l’écran. Enfin, la troisième ins- 
truction ajoute le bouton à la vue courante. 

Si le bouton est de type Rounded Rect, vous pouvez également définir sa taille et le 
texte qui y est affiché : 

1 UIButton *monBouton = [UIButton but t onWi thType : 
UIButtonTypeRoundedRect ]; 
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2 [monBouton setFrame : CGRectMake ( 100 . Of , 100. Of, 100. Of, 20. Of ) ] ; 

3 [monBouton setTitle: @"Mon bouton" forState: 

UlCont r olS t at eMormal ] ; 

4 [self . view addSubview : monBouton]; 

La première instruction définit l’objet monBouton, le rattache à la classe UIButton 
et définit son type UIButtonTypelnf oDark. La deuxième instruction définit la posi- 
tion (les deux premiers paramètres) et les dimensions (les deux derniers paramètres) 
du bouton. La troisième instruction définit le texte affiché dans le bouton. Enfin, la 
quatrième instruction ajoute le bouton à la vue courante. 

Les boutons relèvent de la classe UIButton. L’événement déclencheur par défaut est 
Touch Up Inside ; en d’autres termes, lorsqu’un doigt est enlevé du bouton. Si néces- 
saire, il est possible d’utiliser plusieurs autres déclencheurs. Par exemple Touch Down 
(lorsqu’un doigt est posé sur le bouton), Value Changed (modification du texte du 
bouton) ou encore Touch Drag Inside (appui sur le bouton et déplacement du doigt). 

J'ai défini une action et une méthode événementielle pour mon bouton, mais 
lorsque j'appuie dessus, rien ne se passe. Est-ce que j'aurais raté quelque 
chose ? 

Il y a de grandes chances pour que vous n’ayez pas relié le bouton et le code. Contrôle- 
glissez-déposez le bouton de la zone d’édition sur le fichier d’en-têtes, juste au-dessus 
du @end. Au relâchement du bouton gauche de la souris, sélectionnez Action dans la 
liste Connection, donnez un nom à l’action et cliquez sur Connect. 



Segmented Control 

Les contrôles Segmented Control sont comparables à des onglets. Ils sont utilisés pour 
afficher ou cacher certains éléments en fonction de l’onglet (ou plutôt du « segment » 
dans le jargon Xcode) sélectionné. Ils sont attachés à la classe UlSegmentedControl. 
Supposons par exemple que vous ayez attaché plusieurs images à votre projet. En 
utilisant un Segmented Control, vous pouvez afficher une image pour chaque onglet. 
Nous allons mettre cela en pratique. 

Définissez une nouvelle application basée sur le modèle Single View Application 
et donnez-lui le nom « onglets ». En utilisant Interface Builder, ajoutez au fichier 
MainStoryboard. storyboard un contrôle Segmented Control, un contrôle Image View 
et un contrôle Label. Positionnez et redimensionnez ces contrôles pour obtenir quelque 
chose comme la figure 13.4. 
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Figure 13.4 - Les contrôles doivent être placés de la sorte 

Contrôle-glissez-déposez les contrôles de la zone d’édition sur le code du fichier d’en- 
têtes ViewController .h et définissez les connexions suivantes : 


Contrôle 

Type de liaison 

Nom 

Segmented Control 

Outlet 

onglets 

Segmented Control 

Action 

ongletChange 

Image View 

Outlet 

image 

Label 

Outlet 

sousTitre 


Le fichier ViewController .h doit maintenant contenir les instructions suivantes 


# import <UIKit/UIKit ,h> 

©interface ViewController : UlViewController 
©property (weak , nonatomic) IBOutlet UlSegmentedControl * 
onglets ; 

- (IBAction) ongletChange : (id) sender ; 

©property (weak, nonatomic) IBOutlet UlImageView ♦image; 
©property (weak, nonatomic) IBOutlet UILabel ♦sousTitre; 


3end 


Cette première étape effectuée, vous allez ajouter un onglet au Segmented Control et 
redéfinir le nom des trois onglets. Commencez par sélectionner le Segmented Control 
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dans le canevas, cliquez sur l’icône Show the Attributes inspector dans la partie 
supérieure du volet des utilitaires. Inscrivez « 3 » dans la propriété Segments et appuyez 
sur la touche | Entrée ) de votre clavier. Le contrôle comporte maintenant trois onglets. 

Double-cliquez successivement sur chaque onglet dans la zone d’édition et renommez- 
les « Premier », « Deuxième » et « Troisième ». Si les onglets se recouvrent l’un l’autre, 
redimensionnez le Segmented Control pour arranger les choses. L’interface doit main- 
tenant ressembler à la figure 13.5. 



Figure 13.5 - L’interface de l’application 

Définissez un dossier « Resources » et ajoutez trois images de 320 x 480 pixels dans ce 
dossier. Si cette manipulation vous échappe, reportez-vous à la section « Afficher une 
image » du chapitre 10 (page 159). À la figure 13.6 se trouvent les trois images que j’ai 
utilisées. Elles proviennent de la bibliothèque de cliparts de Microsoft Office. 




Figure 13.6 - Les trois images utilisées dans l’exemple 


228 


SEGMENTED CONTROL 
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Il est temps d’écrire quelques lignes de code. Aucune image n’ayant été affectée au 
contrôle Image View, ni aucun texte au contrôle Label, nous allons le faire via la 
méthode viewDidLoad. 

Cliquez sur ViewController .m dans le volet de navigation et modifiez la méthode 
viewDidLoad comme suit : 

1 - ( vo id ) viewDidLoad 

2 { 

3 [super viewDidLoad]; 

4 Ullmage ♦imageCourante = [Ullmage imageNamed : © " cheval . j pg "] ; 

5 [image setlmage: imageCourant e ] ; 

6 sousTitre . text = © " Un cheval et sa cavalière"; 

7 } 


Télécharger les images 
Code web : 760903 


La ligne 4 définit l’objet Ullmage imageCourant e (Ullmage ♦imageCourante) et lui 
affecte l’image « cheval.jpg » qui se trouve dans les ressources de l’application (= 
[Ullmage imageNamed: @ " cheval . jpg"] ) : 

l| Ullmage ♦imageCourante = [Ullmage imageNamed: © " cheval . j pg "] ; 

La ligne 5 affecte l’objet imageCourante au contrôle imageView image, et provoque 
son affichage : 

l| [image setlmage: imageCourante]; 

Enfin, la ligne 6 affiche un texte dans le Label : 

1 sousTitre . text = ©"Un cheval et sa cavalière"; 


Pour terminer l’application, il ne reste plus qu’à réagir aux changements d’onglets en 
affichant les images et le texte correspondants. Déplacez-vous dans la partie inférieure 
du code et complétez la méthode ongletChange comme suit : 


1 

2 

3 

4 

5 

6 

7 

8 
9 

10 

11 

12 

13 

14 


(IBAction) ongletChange : (id) sender { 
if ( onglets . selectedSegmentlndex == 0) 

{ 

Ullmage ♦imageCourante = [Ullmage imageNamed: ©"cheval. jpg 

] ; 

[image setlmage: imageCourante]; 

s ousTit re . t ext = ©"Un cheval et sa cavalière"; 

} 

if ( onglets . selectedSegmentlndex == 1) 

{ 

Ullmage ♦imageCourante = [Ullmage imageNamed: ©"chien.jpg" 

] ; 

[image setlmage: imageCourante]; 
s ousTit re . text = ©"Un chien"; 

} 

if ( onglets . selectedSegmentlndex == 2) 
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15 

16 

17 

18 

19 

20 


{ 

Ullmage * imageCourante = [Ullmage imageNamed : chat . jpg "] ; 

[image setlmage: imageCourante]; 
sousTitre . text = @"Un chat"; 

} 

} 


Cette méthode est appelée chaque fois que l’utilisateur change d’onglet. Pour sa- 
voir quel onglet a été sélectionné, il suffit de lire la valeur stockée dans la propriété 
selectedSegmentlndex du contrôle Segmented Index (ici onglets). Cette propriété 
vaut 0 lorsque le premier onglet a été sélectionné, 1 lorsque le deuxième onglet a été 
sélectionné, 2 lorsque le troisième onglet a été sélectionné, et ainsi de suite. Comme 
vous pouvez le remarquer, la méthode ongletChange est composée de trois blocs d’ins- 
tructions à peu près similaires. Vous pouvez exécuter le projet. 

À la figure 13.7 se trouve le résultat que j’ai obtenu. 



Figure 13.7 - Le résultat obtenu 


Zones de texte 

Les contrôles Text Field sont des zones de texte monolignes librement éditables par 
l’utilisateur. Lorsque l’utilisateur clique dans une zone de texte, le clavier intégré s’af- 
fiche dans la partie inférieure de l’écran, comme à la figure 13.8. 
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Figure 13.8 - Un clavier apparaît dans la zone inférieure de l’écran 


Lorsque l’utilisateur a terminé la saisie, il appuie sur la touche Return du clavier 
intégré. Ce dernier doit alors disparaître. Pour cela, plusieurs actions sont nécessaires. 


Dans le fichier .h 


Supposons que votre application soit basée sur le modèle Single View Application, 
qu’elle ait pour nom tf (comme Text Field) et que son canevas contienne un contrôle 
Text Field. Vous allez ajouter la déclaration qui apparaît ligne 5 dans le fichier 
ViewController .h : 


1 

2 

3 

4 

5 

6 
7 


# import CUIKit/UIKit .h> 

©interface ViewController : UlViewController 
- (IBAction) saisieKeturn : (id) sender ; 

©end 


Dans le fichier .m 

Définissez le code relatif à la méthode saisieReturn dans le fichier ViewController . m : 

1 - ( IBAction) saisieReturn : (id) sender 

2 { 

3 [sender resignFirstResponder ] ; 

4 } 

Le message [sender resignFirstResponder] ; indique à son destinataire qu’il n’est 
plus le premier répondant. Si cette méthode est reliée à l’événement Did End on Exit 
de la zone de texte, le clavier disparaîtra, puisque la zone de texte n’aura plus le foc.us. 
Dans la prochaine étape, nous allons donc relier l’événement Did End on Exit et la 
méthode saisieReturn. 
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Dans Interface Builder 

Comme à la figure 13.9 : 

- cliquez sur MainStoryboard. storyboard dans le volet de navigation (1) ; 

- cliquez sur la zone de texte dans la vue (2) ; 

- affichez le volet des utilitaires en cliquant sur Hide or Show the Utilities (3) ; 

- affichez les connexions en cliquant sur Show the Connections Inspector (4) ; 

- repérez le bouton radio à droite de Did End On Exit, pointez-le, maintenez le bouton 
gauche de la souris enfoncé et déplacez la souris sur l’icône View Controller (5) ; 

- au relâchement du bouton gauche de la souris, sélectionnez saisieReturn dans le 
menu (6). 



Figure 13.9 - Il faut relier l’événement Did End on Exit et la méthode saisieReturn 

Pour récupérer le contenu d’une zone de texte, il suffit d’utiliser sa propriété text. Nous 
allons illustrer cette propriété en définissant une mini-application composée d’une zone 
de texte et d’un label, comme à la figure 13.10. 

Pour obtenir ce résultat, commencez par définir une application basée sur le modèle 
Single View Application, ajoutez un contrôle Text Field et un contrôle Label au 
canevas. 
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UD 


Aucun texte n'a été entré 


Figure 13.10 - Voici à quoi doit ressembler notre application 


L’application n’a pas encore l’apparence souhaitée. Vous devez modifier deux para- 
mètres dans l’inspecteur des attributs : 

- cliquez sur le contrôle Text Field et écrivez « Entrez du texte ici » dans le 

paramètre Placeholder ; 

- cliquez sur le contrôle Label et tapez « Aucun texte n’a été entré » dans le paramètre 

Text. 

Pour les étourdis, je rappelle que l’inspecteur des attributs est affiché en cliquant 
respectivement sur l’icône Hide or show the Utilities et Show the Attributes 
inspector. Il suffit alors de modifier l’attribut souhaité . 

Vous allez maintenant relier ces deux contrôles au code de l’application : 

- Cliquez sur l’icône Show the Assistant editor dans la barre d’outils de Xcode. 

- Contrôle-glissez-déposez le contrôle Text Field du canevas dans le code source du 
fichier ViewController .h et créez l’outlet saisie. 

- Contrôle-glissez-déposez le contrôle Label du canevas dans le code source du fichier 
ViewController .h et créez l’outlet status. 

Après ces manipulations, le fichier ViewController .h devrait contenir les instructions 
suivantes : 

# import CUIKit/UIKit .h> 


1 

2 

3 


^interface ViewController : UlViewController 
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4 

5 - ( IB Act ion ) sais ieRet urn : ( id) sender ; 

6 Sproperty (weak , nonatomic) IBOutlet UITextField ^saisie ; 

7 Oproperty (weak, nonatomic) IBOutlet UILabel ♦status; 

8 

9 Oend 

Nous allons supposer que l’effacement du clavier a été mis en place lorsque l’utilisateur 
appuie sur la touche Return, comme indiqué précédemment. Une ligne supplémentaire 
dans la méthode saisieReturn va suffire pour afficher le contenu de la zone de texte 
dans le Label (ici la ligne 3) : 

1 - ( IB Act ion ) sais ieRet urn : ( id) sender 

2 { 

3 status . text = [NSString stringWithFormat: <§"’/, @"Vous 

avez tapé : ", saisie . text ] ; 

4 [sender res ignFir s tResponder ] ; 

5 } 

La propriété text du contrôle Label (status . text) est initialisée avec l’objet NSString 
retourné par le message qui suit le signe « = ». Cet objet est constitué par la concaté- 
nation (c’est-à-dire l’ajout) de deux textes (stringWithFormat: @"°/ 0 @°/»@") : la chaîne 
« Vous avez tapé » (@"Vous avez tapé : ") et le contenu du contrôle Text Field 
(saisie . text). 


Curseurs 

Les contrôles Slider (figure 13.11) sont des curseurs horizontaux dont la position est 
ajustable par l’utilisateur. Vous les utiliserez pour faciliter la sélection de valeurs dans 
des plages. 


Figure 13.11 - Un contrôle Slider 

Ces contrôles relèvent de la classe UISlider. Il est possible de les personnaliser dans 
Interface Builder en définissant : 

- une image pour représenter la valeur minimale et une autre pour représenter la valeur 
maximale ; 

- les valeurs minimales et maximales ; 

- la valeur par défaut au lancement de l’application. 

La position du curseur est accessible à tout moment dans la propriété value. 

Pour illustrer le fonctionnement de ce contrôle, nous allons créer une mini-application 
qui affiche dans un Label la position d’un Slider, et ce à chaque modification du 
curseur par l’utilisateur. 
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Définissez un nouveau projet en utilisant le modèle Single View Application et 
donnez-lui le nom « slider ». Ajoutez un Slider et un Label au canevas. Reliez le 
Label au fichier .h; pour cela, effectuez un contrôle-glisser-déposer du Label dans le 
fichier .h et donnez le nom status à l’outlet ainsi créé. 

Reliez le Slider au fichier .h. Pour cela, effectuez un contrôle-glisser-déposer du Slider 
dans le fichier .h. Au relâchement du bouton gauche de la souris, sélectionnez Action 
dans la liste Connection, choisissez Value Changed dans la liste Event et tapez « si » 
dans la zone de texte Name. 

Le fichier .h doit maintenant ressembler à ceci : 

1 # import <UIKit/UIKit.h> 

2 

3 ©interface ViewCont r oller : UlViewController 

4 ©property (weak , nonatomic) IBOutlet UILabel ♦status ; 

5 - ( IBAction) si : ( id) sender ; 

6 

7 ©end 


Pour compléter ces définitions, vous devez définir quelques lignes de code dans la mé- 
thode si qui, rappelons-le, réagit à l’événement Value Changed du Slider : 


1 

2 

3 

4 

5 


- ( IBAction) si :( id) sender { 

UISlider ♦slider = (UISlider ♦) sender; 

status . text = [NSString s tringWithFormat :©"’/, 1 . 2f " , slider. 
value ] ; 


} 


La ligne 2 définit l’objet slider de type UISlider et le relie au Slider qui est à l’origine 
de l’événement. La ligne 3 convertit la propriété value du Slider (slider . value) 
en un objet NSString (NSString stringWithFormat : . 2f " , . . .). L’objet ainsi 

obtenu est placé dans la propriété text du Label status (status. text = . . .), ce 
qui provoque l’affichage de la valeur du curseur dans le label. 


Interrupteurs 

Vous utiliserez un contrôle Switch chaque fois qu’il est nécessaire de mettre en place 
un interrupteur marche/arrêt, comme celui utilisé dans les réglages du device pour le 
mode avion (figure 13.12). 

Le contrôle Switch relève de la classe UI Switch. La propriété booléenne on permet 
de connaître son état et la méthode setûn de le modifier. Voici la syntaxe de cette 
méthode : 

l| - ( vo id ) set On : ( BOOL ) on animated : ( BOOL ) animated 

Donnez la valeur : 
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U Mode Avion 



Figure 13.12 - Un contrôle Switch pour le mode avion 


- YES ou NO au paramètre on selon que vous vouliez mettre l’interrupteur sur ON ou 
sur OFF. 

- YES ou NO au paramètre animated selon que vous vouliez changer l’état de l’inter- 
rupteur ; c’est-à-dire avec ou sans animation. 

Pour illustrer l’utilisation de ce contrôle, nous allons définir une mini-application qui 
affiche l’état d’un interrupteur marche/arrêt chaque fois que celui-ci change. 

Définissez un nouveau projet en utilisant le modèle Single View Application et 
donnez-lui le nom « switch ». Ajoutez un Switch et un Label au canevas. 

Reliez le Label au fichier .h en effectuant un contrôle-glisser-déposer du Label dans 
le fichier .h et donnez le nom « status » à l’outlet ainsi créé. 

Reliez le Switch au fichier .h en effectuant un contrôle-glisser-déposer du Switch dans 
le fichier .h. Au relâchement du bouton gauche de la souris, sélectionnez Action dans 
la liste Connection, choisissez Value Changed dans la liste Event et tapez « sw » dans 
la zone de texte Name. 

Le fichier .h doit maintenant ressembler à ceci : 

1 # import <UIKit/UIKit.h> 

2 

3 ^interface ViewController : UlViewController 

4 (Sproperty (weak , nonatomic) IBOutlet UILabel *status; 

5 - ( IBAction) sw : ( id) sender ; 

6 

7 ®end 

Pour compléter ces définitions, vous devez définir quelques lignes de code dans la mé- 
thode sw qui, rappelons-le, réagit à l’événement Value Changed du Switch. Cliquez 
sur ViewController .m dans le volet de navigation puis modifiez la méthode sw comme 
suit : 


1 

- ( IBAction) sw : 

( id) sender { 



2 

UlSwitch *uis 

= (UlSwitch *) 

sender 


3 

if (uis . on == 

TRUE) 




4 

status . text 

= @ " Le 

switch 

est sur 

ON" ; 

5 

else 





6 

status . text 

= @ " Le 

switch 

est sur 

OFF" 

7 

} 






La deuxième ligne définit l’objet uis de classe UlSwitch et le relie au switch qui est à 
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l’origine de l’événement. La ligne suivante teste la valeur de la propriété on du switch. 
Si cette propriété vaut TRUE, cela signifie que l’interrupteur vient d’être initialisé à ON. 
Le texte « Le switch est sur ON » est alors affiché dans le label : 

l| status . text = @"Le switch est sur ON"; 

Dans le cas contraire, cela signifie que l’interrupteur vient d’être initialisé à OFF. Le 
texte « Le switch est sur OFF » est alors affiché dans le label : 

1 else 

2 status . text = @"Le switch est sur OFF"; 


Contrôles de page 

Les contrôles Page Control sont utilisés dans une vue qui comporte plusieurs pages. 
Ils permettent à l’utilisateur : 

1. de savoir où se situe la page courante dans l’ensemble des pages ; 

2. de se déplacer dans l’ensemble des pages. 

Ces contrôles relèvent de la classe UlPageControl. Pour vous montrer comment les 
utiliser, nous allons développer une application dans laquelle un contrôle Scroll View 
contient des zones colorées mises bout à bout. Comme vous pouvez le voir sur l’image 
13.13, le Scroll View est bien plus large que l’écran de l’iPhone : il comporte cinq 
zones colorées de la même taille que l’écran. 



Figure 13.13 - Le contrôle Scroll View contient des zones colorées mises bout à bout 

Définissez une nouvelle application basée sur le modèle Single View Application et 
donnez-lui le nom « page ». En utilisant Interface Builder, ajoutez un contrôle Scroll 
View au fichier MainStoryboard. storyboard, et redimensionnez-le pour qu’il occupe 
la quasi-totalité de l’écran. 
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Contrôle-glissez-déposez le contrôle Scroll View de la zone d’édition dans le code du 
fichier d’en-têtes ViewController .m et définissez l’outlet sv. Le fichier d’en-têtes doit 
maintenant ressembler à ceci : 

1 # import <UIKit/UIKit.h> 

2 

3 ©interface ViewController : UlViewController 

4 ©property (weak , nonatomic) IBOutlet UIScrollView ♦ sv; 

5 

6 ©end 


Nous allons maintenant définir les rectangles colorés qui seront affichés dans le contrôle 
Scroll View. 

Pour qu’un rectangle représente une page dans le Scroll View, il suffit de lui don- 
ner la même taille que le Scroll View. Pour cela, nous allons utiliser la méthode 
viewDidLoad. Cliquez sur ViewController .m dans le volet de navigation et complétez 
la méthode viewDidLoad comme ceci : 


1 

2 

3 

4 


5 

6 

7 

8 
9 

10 

11 

12 

13 

14 

15 

16 

17 

18 

19 

20 


- (void) viewDidLoad 

{ 

[super viewDidLoad]; 

NSArray ♦couleurs = [NSArray arr ayWithOb j e et s : [UlColor 

redColor] , [UlColor greenColor] , [UlColor blueColor] , [ 

UlColor cyanColor] , [UlColor yellowColor] , nil] ; 
for (int i = 0; i < couleurs . count ; i++) 

{ 

// Définition d'un rectangle 
CGRect rectangle; 

rectangle . origin . x = sv . f rame . size . width * i; 
rectangle . origin . y = 0; 

rectangle . size = s v . f rame . size ; //Le rectangle a la même 
dimension que le UIScrollView 

// Ajout de la vue correspondante 

UlView ♦subview = [[UlView alloc] initWithFrame : rectangle ] ; 
subview . backgroundColor = [couleurs ob j e et At Index : i] ; 

[sv addSubview : subview] ; 

} 

sv . contentSize = CGSizeMake ( s v . f rame . s ize . width ♦ couleurs, 
count, sv . f rame . size . height ) ; 

} 


> 


La ligne 4 définit un objet NSArray nommé couleurs (NSArray ♦couleurs) et l’ini- 
tialise avec cinq couleurs prédéfinies. 

Le bloc d’instructions suivant (lignes 5 à 17) définit les cinq rectangles et les transforme 
en vues du contrôle Scroll View. Pour bien faire les choses, la boucle for utilise 


Copier ce code 
Code web : 898165 
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le nombre de couleurs définies dans le tableau couleurs (couleurs . count) comme 
borne supérieure. Ainsi, si vous voulez définir plus ou moins de couleurs, l’application 
fonctionnera tout aussi bien : 


1 

2 

3 

4 


for ( int i 

{ 

} 


0; i < couleurs . count ; i++) 


Les rectangles sont des objets CGRect. La première instruction de la boucle (ligne 8) 
commence par définir un objet rectangle de type CGRect : 

1 | CGRect rectangle ; 

Les trois instructions suivantes définissent l’origine et la taille du rectangle : 

1 rectangle . origin . x = s v . f rame . s ize . width * i; 

2 rectangle . or igin . y = 0; 

3 rectangle . size = s v . f rame . s ize ; 

Remarquez la façon dont est définie l’abscisse (rectangle . origin. x) du rectangle : 
l| rectangle . origin . x = s v . f rame . s ize . width * i; 

La propriété f rame . size . width de l’objet UIScrollView sv donne la largeur de ce 
contrôle. En la multipliant par l’index de la boucle, qui vaut consécutivement 0, 1, 2, 
3 puis 4, on obtient les valeurs suivantes : 


Index 

rectangle . origin . x 

0 

0 

1 

Largeur de sv 

2 

2 largeurs de sv 

3 

3 largeurs de sv 

4 

4 largeurs de sv 


Les cinq rectangles colorés seront donc placés côte à côte horizontalement. 

Les instructions suivantes (lignes 14 à 16) définissent les différentes vues qui com- 
posent l’objet Scroll View. Pour cela, un objet subview de classe UlView est dé- 
fini (UlView * subview) et initialisé avec le rectangle créé quelques lignes plus haut 
(initWithFrame : rectangle) : 

l| UlView ♦subview = [[UlView alloc] initWithFrame : rect angle ] ; 

La couleur de cet objet est alors initialisée avec la couleur définie dans l’élément d’index 
i du tableau : 

l| subview . backgroundColor = [couleurs ob j e et At Index : i ] ; 


La sous- vue est enfin définie en utilisant l’objet subview : 
1 [sv addSubview : subview] ; 
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Vous pouvez lancer l’application et constater (oh merveille !) qu’il est possible de scroller 
horizontalement dans le Scroll View. Vous allez maintenant ajouter un contrôle Page 
Control au fichier ViewController . xib. Par défaut, le nombre de pages accessibles via 
un Page Control est égal à trois. Dans notre cas, nous devons scroller à travers cinq 
pages. Il faut donc modifier le nombre de pages par défaut. Cliquez sur le Page Control 
dans la zone d’édition, affichez le volet des attributs (si nécessaire en cliquant sur Hide 
or show the Utilities puis sur Show the Attributes inspector) et modifiez la 
valeur de l’attribut Pages, comme indiqué à la figure 13.14. 


T Page Control J 


Pages ïfç) olî] 

# of Pages Current 

Behavior (_l Hides for Single Page 

O Defers Page Display 

▼ Control 

Alignment ( p P | P El ) 

Horizontal 

i n S EL ffl 

Vertical 

Content O Selected (ÿjf Enabled 

Q Highlighted 

▼ View 

Mode l Scale Ta Fill : 

Tag OtJ 

Interaction |Vf User Interaction Enabled 

O Multiple Touch 

Alpha 1]^ 

Background ; i i Default î | 


Drawing Q Opaque Q Hidden 


Figure 13.14 - Il faut modifier le nombre de pages accessibles par défaut 

Définissez un outlet et une action pour le contrôle Page Control et nommez-les (respec- 
tivement) « laPage » et « changePage ». Le fichier d’en-têtes doit maintenant ressembler 
à ceci : 

1 # import <UIKit/UIKit.h> 

2 

3 ^interface ViewController : UlViewController 

4 Sproperty (weak , nonatomic) IBOutlet UIScrollView *sv; 

5 

6 Oproperty (weak, nonatomic) IBOutlet UlPageControl *laPage; 

7 - ( IBAction) changePage :( id) sender ; 

8 ®end 

Pour que le Page Control puisse être mis à jour lorsque l’utilisateur change de page 
en utilisant une gestuelle de glisser, il est nécessaire d’être informé de cette gestuelle. 
Pour cela, nous déléguerons cette tâche au Scroll View. Il est donc nécessaire : 

1. d’ajouter le protocole UIScrollViewDelegate dans le contrôleur de vue, c’est-à- 
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dire dans le fichier ViewController. h; 

2. de connecter le delegate du Scroll View au contrôleur de vue. 



À quoi vont servir ces deux étapes au juste? Je ne suis pas sûr de bien 
comprendre. 


Elles vont permettre d’écrire dans le code du contrôleur de vue (ViewController .m) 
les méthodes événementielles en rapport avec le contrôle Scroll View. En effet, en 
ajoutant le delegate UIScrollViewDelegate au contrôleur de vue et en le reliant au 
contrôleur de vue, ce dernier sera capable de traiter les événements du contrôle Scroll 
View. 

La première étape se fait en spécifiant le protocole dans la déclaration de l’interface : 


©interface ViewController 
UIScrollViewDelegate > 

{ 

} 


UlViewController < 


La deuxième étape se fait en cliquant sur le contrôle Scroll View dans le canevas (1), 
puis en glissant-déposant le cercle à droite de delegate sur l’icône View Controller 
(2), comme à la figure 13.15. 



Figure 13.15 - Un contrôle-glisser-déposer sur l’icône View Controller 
Retournons au code. Cliquez sur ViewController .m dans le volet de navigation. 
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Le contrôleur de vue étant le délégué du Scroll View, nous allons utiliser une méthode 
de ce dernier pour mettre à jour le Page Control. Insérez la méthode suivante à un 
endroit quelconque dans le code. Par exemple juste avant la méthode viewDidLoad : 

1 - ( void) s cr oll ViewD i dScr ol 1 : ( UI Scr ollV iew *)sender { 

2 CGFloat largeurPage = s v . f rame . s ize . width ; 

3 int page = f loor ( ( s v . c ont ent Of f set . x - largeurPage / 2) / 

largeurPage) + 1; 

4 laPage . currentPage = page ; 

5 } 

Cette méthode est exécutée lorsque l’utilisateur déplace horizontalement le Scroll 
View. La ligne 2 stocke la largeur d’une page (c’est-à-dire celle du Scroll View) dans 
la variable CGFloat largeurPage : 

l| CGFloat largeurPage = s v . f rame . s ize . width ; 

La ligne 3 calcule le numéro de la page affichée dans le Scroll View. Ce numéro change 
lorsque la vue est décalée de plus de la moitié de l’écran (figure 13.16). 




Figure 13.16 - Le numéro de page change lorsque la vue est décalée de plus de la 
moitié de l’écran 

Le calcul paraît complexe, mais il n’en est rien. La propriété sv . Content Offset . x 
représente le décalage de l’élément affiché dans le Scroll View. Si on lui soustrait la 
moitié de la largeur de la page, et qu’on divise le résultat par la largeur de la page, on 
obtient : 

- 0 lors du scroll de la page 1 à la page 2 

- 1 lors du scroll de la page 2 à la page 3 

- etc. 
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En ajoutant 1 à cette valeur, on obtient exactement ce qui est recherché, à savoir le 
numéro de la page vers laquelle l’utilisateur se déplace. 

Toujours dans le flou? Passons à une application numérique. Nous allons supposer que 
le device utilisé est un iPhone 3G. Bien sûr, ce raisonnement fonctionne sur tous les 
autres devices, mais il fallait bien en choisir un pour passer à l’application numérique. 

La résolution d’un iPhone 3G est de 320 x 480 pixels. Supposons que l’utilisateur soit 
en train d’effectuer une gestuelle pour passer du premier écran au deuxième (comme 
sur la figure précédente). Examinons les valeurs des différents éléments contenus dans la 
formule floor( (sv . contentOff set . x - largeurPage / 2) / largeurPage) + 1. 


L’élément 

va passer de . . . à . . . 

sv.contentOffset.x 

0 à 320 

sv.contentOffset.x - largeurPage / 2 

-160 à 160 

(sv.contentOffset.x - largeurPage / 2) / largeurPage 

-0.5 à 0.5 

floor((sv.contentOffset.x - largeurPage / 2) / largeur- 

-1 jusqu’au milieu de 

Page) 

l’écran, 0 après 

floor((sv.contentOffset.x - largeurPage / 2) / largeur- 

0 jusqu’au milieu de 

Page) + 1 

l’écran, 1 après 


Libre à vous de décomposer les calculs pour le passage du deuxième au troisième écran, 
du troisième au quatrième et du quatrième au cinquième. Vous verrez, cela fonctionne. 

Si vous vous demandez comment j’ai pu trouver cette formule, eh bien, je me suis 
demandé quel résultat je voulais obtenir et après deux ou trois essais infructueux, je 
suis arrivé à définir la bonne formule. Cette approche fonctionne bien pour toutes sortes 
de formules, qu’elles soient plus simples ou plus complexes. . . 

Retournons au code de l’application. Pour mettre à jour en conséquence le Page 
Control, il suffit d’affecter la valeur que l’on vient de calculer à sa propriété currentPage : 

1 | laPage . currentPage = page ; 

Pour terminer, nous allons compléter la méthode action changePage pour réagir aux 
actions de l’utilisateur sur le Page Control. En effet, pour le moment, ce contrôle est 
juste utilisé pour afficher la page active, mais pas pour changer de page. Rassurez-vous : 
le code sera bien plus simple que le précédent. 

Localisez la méthode changePage et complétez-la comme suit : 

1 - ( IBAction) changePage :( id) sender { 

2 CGRect f rame ; 

3 f rame . origin . x = sv . f rame . size . width * laPage . currentPage ; 

4 f rame . or igin . y = 0; 

5 frame.size = s v . f rame . s ize ; 

6 [sv s cr ollRe et ToVi s ible : f rame animated : YES] ; 

7 } 

La ligne 2 définit la variable frame de type CGRect. Le code se poursuit en définissant 
l’abscisse et l’ordonnée de l’affichage. Si vous n’avez qu’une vague idée de ce que repré- 
sentent ces termes mathématiques, la figure 13.17 va vous rappeler de vieux souvenirs. 
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Axe des abscisses 


Figure 13.17 - Abscisse et ordonnée 


La ligne 3 définit le décalage en abscisse (frame.origin.x) de l’affichage : 
l| frame.origin.x = sv . f rame . size . width * laPage . currentPage ; 

Ce décalage est calculé en multipliant le numéro de la page courante par la largeur 
d’une page. 

L’ordonnée de l’affichage est toujours égale à zéro : 
l| f rame . or igin . y = 0; 

Et la propriété size du rectangle est mise à jour avec les composantes x et y qui 
viennent d’être calculées : 

l| f rame. size = s v . f rame . s ize ; 

Il ne reste plus qu’à mettre à jour l’affichage dans le Scroll View en définissant 
le rectangle visible (scrollRectToVisible : frame) et en demandant une animation 
(animated: YES) : 

l| [sv scrollRectToVisible : frame animat ed : YES ] ; 

Vous pouvez (enfin) exécuter l’application et profiter du résultat ! 


En résumé 

- Les boutons sont les contrôles d’action de base. Leur apparence peut être person- 
nalisée en utilisant Interface Builder ou des instructions Objective-C. Vous pouvez 
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par exemple choisir la forme, le texte, l’image, la couleur d’arrière-plan et encore 
beaucoup d’autres caractéristiques. 

- Les contrôles Segmented Control sont comparables à des onglets. Ils sont utili- 
sés pour afficher ou cacher certains éléments en fonction de l’onglet (ou plutôt 
du « segment » dans le jargon Xcode) sélectionné. Ils sont attachés à la classe 

UlSegmentedControl. 

- Les contrôles Text Field sont des zones de texte monolignes librement éditables 
par l’utilisateur. Lorsque l’utilisateur clique dans un Text Field, le clavier intégré 
s’affiche dans la partie inférieure de l’écran. 

- Les contrôles Slider sont des curseurs horizontaux dont la position est ajustable par 
l’utilisateur. Vous les utiliserez pour faciliter la sélection de valeurs dans des plages. 

- Vous utiliserez un contrôle Switch chaque fois qu’il est nécessaire de mettre en place 
un interrupteur marche/arrêt, comme celui utilisé dans les réglages du device poul- 
ie mode avion. 

- Les contrôles Page Control sont utilisés dans une vue qui comporte plusieurs pages. 
Ils permettent à l’utilisateur de savoir où se situe la page courante dans l’ensemble 
des pages et de se déplacer dans l’ensemble des pages. 
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Barres et tabulations 


Difficulté : or 

C e chapitre s'intéresse aux contrôles et aux modèles de conception utilisés pour gérer 
les différentes vues d'une application. Au fil des pages, vous apprendrez à définir des 
tabulations, à mettre en place une barre de navigation, une barre d'outils et une 
barre de recherche, mais aussi à gérer deux vues simultanément sur un iPad, comme dans 
l'application de messagerie Mail, fournie en standard avec les iPad 1 et 2. 

À la fin du chapitre, vous aurez une plus grande maîtrise du storyboard (l'outil de conception 
des vues de Xcode). Vous verrez à quel point il peut simplifier (voire même automatiser 
dans certains cas) la définition des vues et de leurs interconnexions. 

Cette version de Xcode marque clairement le début d'une nouvelle ère dans la conception 
des applications. À présent, le programmeur passe un peu plus de temps à peaufiner son 
interface et un peu moins de temps à aligner du code. Et de nombreux blocs de code sont 
générés automatiquement. Qui s'en plaindrait? 


RECHERCHE O s 
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Applications multivues 

Les contrôles Tab Bar permettent de créer facilement des applications multivues. L’uti- 
lisateur passe d’une vue à l’autre en cliquant sur les icônes du contrôle Tab Bar, comme 
le montre la figure 14.1. 



First View 


Les contrôles Tab Bar 
permettent de changer 
de vue simplement 


1 



Figure 14.1 - Les contrôles Tab Bar permettent de changer de vue simplement 

Les contrôles Tab Bar sont rattachés à la classe UITabBar. Nous allons voir comment 
les mettre en place en développant une petite application contenant trois vues. 

Commencez par définir une application basée sur le modèle Tabbed Application et 
donnez-lui le nom « tabBar ». Cliquez sur MainStoryboard. storyboard dans le volet 
de navigation. La figure 14.2 montre comment se présente le canevas. 

Comme vous pouvez le voir : 

- un contrôleur Tab Bar et deux contrôleurs de vues ont automatiquement été insérés 
dans le canevas ; 

- des liaisons entre le contrôleur Tab Bar et les contrôleurs de vues ont été mises en 
place ; 

- un contrôle Tab Bar a été inséré dans la partie inférieure de la vue principale (Tab 
Bar Controller) ; 

- les deux vues secondaires contiennent plusieurs contrôles. 

L’application est déjà opérationnelle (figure 14.3). Juste pour vous faire plaisir, cliquez 
sur Run et amusez-vous avec les différentes vues qui ont automatiquement été mises en 
place lors de la création de l’application. 
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Figure 14.2 - Voici comment se présente le canevas 



Op««a«eur ? 14:56 


First View 


loaoed By me tirst view comroiw - an 
instance of ftrstViewController — 
specitod in me app deiegate 



Operateui ? 14:57 


Second View 


toaded try me second view controœr - 
an instance ot SecondVIewController - 
specilied m me app deiegate 



Figure 14.3 - L’application est opérationnelle, il est possible de changer de vue 
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Cette application comporte deux vues. Pour vous amuser, je vous propose d’insérer une 
troisième vue et de la relier au Tab Bar Controller, comme indiqué à la figure 14.4. 

- Glissez-déposez un View Controller de la bibliothèque d’objets sur le canevas (1). 

- Maintenez la touche ( Ctrl ) enfoncée, cliquez sur le Tab Bar Controller, maintenez 
le bouton gauche de la souris enfoncé et dirigez son pointeur sur la nouvelle vue (2). 

- Relâchez la touche ( Ctrl ) et le bouton de la souris et sélectionnez Relationship - 
viewControllers dans le menu (3). 



Ça y est : vous venez d’insérer une troisième vue dans le projet et de la relier au Tab 
Bar Controller. Je sens que vous avez du mal à me croire. Allez, cliquez sur Run et 
admirez le résultat (figure 14.5). 

Vous allez maintenant modifier les icônes des trois vues. Pour cela, vous aurez besoin 
d’icônes de 32 x 32 pixels. Vous trouverez sans peine de telles icônes sur le Web en 
tapant « icônes 32x32 » dans votre moteur de recherche préféré. Définissez un dossier 
« ressources » et ajoutez-y trois icônes de votre choix. 

Vous pouvez également télécharger les icônes que j’ai utilisées (figure 14.6) pour vous 
faciliter la tâche, mais rien ne vous empêche de créer les vôtres. 

[Télécharger les icônes 
[ Code web : 112628 y 

Pour modifier l’apparence d’un Tab Bar Item, vous allez utiliser l’inspecteur des at- 
tributs. 
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Figure 14.5 - L’application comporte trois vues 


# o m 


Figure 14.6 - Les icônes que j’ai utilisées dans l’application 


Comme indiqué à la figure 14.7, cliquez sur l’icône Hide or show the Utilities 
(1) pour faire apparaître le volet des utilitaires, puis cliquez sur l’icône Show the 
Attributes inspector (2). L’inspecteur des attributs étant affiché, cliquez sur le Tab 
Bar Item de la première vue (3), et modifiez les paramètres Title et Image, sous Bar 
Item (4). 

Recommencez cette manipulation pour modifier les deux autres Tab Bar Item. 

Maintenant, il ne vous reste plus qu’à insérer le contenu souhaité dans les trois vues 
pour finaliser l’application. Je suis sûr que cela ne vous posera aucun problème. 

Le code de l’application ne sera pas listé ici, car aucun code n’a été écrit. Je ne sais 
pas ce que vous en pensez, mais moi, je tire mon chapeau aux ingénieurs qui ont conçu 
cette nouvelle version de Xcode. On peut dire qu’elle facilite vraiment les choses. Ceux 
et celles qui ont connu les versions précédentes ne me contrediront certainement pas ! 


Barre d’outils 

Vous utiliserez un contrôle Tool Bar chaque fois qu’il est nécessaire d’ajouter une barre 
d’outils dans une application. Ces contrôles relèvent de la classe UIToolBar. Ils peuvent 
être composés d’un ou de plusieurs boutons rattachés à la classe UIBarButtonltem. Ces 
boutons peuvent contenir du texte et/ou une image. 
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Figure 14.7 - Il faut utiliser l’inspecteur des attributs pour modifier l’apparence d’un 
Tab Bar Item 
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Pour vous entraîner à manipuler les contrôles Tool Bar, vous allez définir une appli- 
cation dans laquelle quatre boutons permettront de changer la couleur et l’alignement 
du texte affiché dans un Label. À la figure 14.8 se trouve le résultat à obtenir. 



Un simple Label pour illustrer 
le fonctionnement du contrôle 
Tool Bar 



Figure 14.8 - L’application doit ressembler à ça 


Créez une nouvelle application de type Single View Application et donnez-lui le 
nom « toolBar ». Cliquez sur l’entrée MainStoryboard. storyboard dans le volet de 
navigation. En utilisant Interface Builder, ajoutez un contrôle Tool Bar à l’application 
et positionnez-le tout en bas de la fenêtre. Ajoutez trois Bar Button Items au Tool 
Bar pour obtenir quelque chose approchant de la figure 14.9. 

Double-cliquez successivement sur chacun des quatre Bar Button Items et affectez- 
leur les libellés suivants : « Noir », « Rouge », « Gauche » et « Centre ». 

Ajoutez un contrôle Label à l’application. Affectez-lui le texte « Un simple Label pour 
illustrer le fonctionnement du contrôle Tool Bar ». Redimensionnez ce contrôle pour 
qu’il tienne sur plusieurs lignes et affectez la valeur 3 au paramètre Lines. 

Pour que le code puisse interagir avec les contrôles déposés sur l’application, vous allez 
définir des actions et un outlet. Cliquez sur l’icône Show the Assistant Editor et 
contrôle-glissez-déposez successivement les quatre Bar Button Items juste au-dessus 
du @end final dans le fichier d’en-têtes. Définissez les actions noir, rouge, gauche et 
centre. 


Définissez l’outlet leLabel pour le contrôle Label. 

Le fichier ViewController .h doit maintenant ressembler à ceci : 
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Figure 14.9 - Positionnez les éléments de cette façon 


1 

2 

3 

4 

5 

6 

7 

8 
9 

10 

11 


# import CUIKit/UIKit .h> 

Sinterface ViewController : UlViewController 

- ( IBAction) noir : ( id) sender ; 

- ( IBAction) rouge :( id) sender ; 

- ( IBAction) gauche :( id) sender ; 

- ( IBAction) centre :( id) sender ; 

Sproperty (weak , nonatomic) IBOutlet UILabel *leLabel; 
Oend 


Il ne reste plus qu’à écrire quelques lignes de code pour réagir aux appuis sur les Bar 
Button Items. Cliquez sur ViewController .m dans le volet de navigation. Repérez les 
méthodes action et complétez-les comme ceci : 

1 - ( IBAction) noir :( id) sender { 

2 leLabel . textColor = [UlColor blackColor]; 

3 } 

4 

5 - ( IBAction) rouge :( id) sender { 

6 leLabel . textColor = [UlColor redColor] ; 

7 } 

8 
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9 

10 

11 

12 

13 

14 

15 


- ( IB Act i on ) gauche :( id ) sender { 

leLabel . t ex t Al i gnment = UIText AlignmentLef t ; 

} 

- ( IBAct ion) centre :( id) sender { 

leLabel . text Alignment = UIText Alignment Center ; 

} 


Barre de recherche 

Le contrôle Search Bar est très pratique lorsqu’il est nécessaire d’effectuer une re- 
cherche dans une application. Ce contrôle relève de la classe UISearchBar. Je vais vous 
montrer comment l’utiliser pour filtrer les données affichées dans un Table View. À la 
figure 14.10 se trouve le résultat à obtenir. 



Lyon 

Lille 

Le Havre 
Le Mans 


□□□□□□□□□□ 

G0QGQD0QDD 

o QQQQQQ « 



w 


Figure 14.10 - L’application doit ressembler à ça 

Définissez une nouvelle application basée sur le modèle Master-Detail Application 
et donnez-lui le nom « searchBar ». Cliquez sur MainStoryboard. storyboard dans le 
volet de navigation et ajoutez un contrôle Search Bar and Search Display Controller 
à la vue Master, comme indiqué à la figure 14.11. 

Cliquez sur Show the Assistant editor pour afficher côte à côte le canevas et le 
code MasterViewController .h, définissez un outlet pour le contrôle Table View et 
donnez-lui le nom « laListe » . 
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Master 



Figure 14.11 - Ajoutez un contrôle Search Bar and Search Display Controller 
à la vue Master 
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Définissez un autre outlet pour le contrôle Search Bar et donnez-lui le nom « re- 
cherche ». 

Lors du développement de l’application, vous aurez besoin de trois variables d’instance 
de type NSMutableArray. Une pour mémoriser la liste des villes dans sa forme originale 
et deux autres pour manipuler la liste filtrée. Ajoutez les instructions suivantes dans 
l’interface de l’application : 

1 NSMutableArray *maListe; 

2 NSMutableArray ♦tampon; 

3 NSMutableArray *tampon2; 


Le fichier MasterViewController .h doit maintenant ressembler à ceci : 


î 

2 

3 

4 

5 

6 

7 

8 
9 

10 

11 

12 

13 


# import CUIKit/UIKit .h> 

©interface ViewCont r oller : UlViewController 

{ 

NSMutableArray ♦maListe ; 

NSMutableArray ♦tampon; 

NSMutableArray ♦tampon2; 

} 

©property (weak, nonatomic) IBOutlet UITableViewCell *laListe; 
©property (weak, nonatomic) IBOutlet UISearchBar ♦recherche ; 

©end 


Pour faire fonctionner cette application, deux étapes sont nécessaires. 

1. Ajout de données textuelles dans le Table View et sauvegarde dans un objet 
NSMutableArray. 

2. Filtrage des données affichées dans le Table View lorsque des informations sont 
entrées dans le contrôle Search Bar. 


Initialisation du Table View 

D’une façon traditionnelle, l’initialisation du Table View se fera dans la méthode 
viewDidLoad du contrôleur de vue principal. Cliquez sur MasterViewController .m 
dans le volet de navigation et complétez la méthode viewDidLoad comme suit : 

1 - ( void ) viewDidLoad 

2 { 

3 [super viewDidLoad]; 

4 maListe = [[NSMutableArray alloc] init]; 

5 tampon = [[NSMutableArray alloc] init]; 

6 [maListe addOb j ect : © " Par is " ] ; 

7 [maListe addOb j ect : @" Lyon "] ; 

8 [maListe addOb j ect :©" Mar sei lie "] ; 

9 [maListe addOb j ect : @" Toulouse "] ; 
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10 

11 

12 

13 

14 

15 

16 

17 

18 

19 

20 
21 
22 

23 


[maListe addObject:< 

[maListe addObject:< 

[maListe addObject:< 

[maListe addObject:< 

[maListe addObject:< 

[maListe addObject:< 

[maListe addObject:< 

[maListe addObject:< 

[maListe addObject:< 

[maListe addObject:< 

[maListe addObject:< 

[maListe addObject:< 

[tampon addObject s Fr omArray : maListe ] ; 
données d'origine 


! " Nantes " ] ; 

! " Nice "] ; 

! " Bordeaux " ] ; 

! " Montpe Hier " ] ; 
! " Rennes " ] ; 

!" Lille " ] ; 

! " Le Havre "] ; 

! " Re ims " ] ; 

! " Le Mans " ] ; 

! " Di j on " ] ; 

! " Grenoble " ] ; 

! " Brest " ] ; 


//Mémorisation des 


> 


Les deux premières instructions ajoutées dans cette méthode réservent de l’espace en 
mémoire pour les objets NSMutableArray maListe et tampon : 

1 maListe = [[NSMutableArray alloc] init]; 

2 tampon = [[NSMutableArray alloc] init]; 


Copier ce code 
Code web : 631625 


Les seize instructions suivantes ajoutent des données dans l’objet maListe : 


[maListe addOb j ect : @ " Paris "] ; 
[maListe addOb j ect : @ " Brest "] ; 


Enfin, la dernière instruction recopie le contenu de l’objet maListe dans l’objet tampon. 
Comme son nom le laisse supposer, l’objet tampon sera utilisé comme sauvegarde de 
l’objet maListe. Nous verrons prochainement pourquoi cette sauvegarde est impor- 
tante. 

Si vous recherchez dans votre mémoire, vous vous rappellerez certainement la technique 
permettant de copier les données d’un NSMutableArray dans un contrôle Table View. 
Vous devez définir les méthodes tableView: tableView numberOfRowslnSection: 
section et tableView: tableView cellForRowAtlndexPath: indexPath. La pre- 
mière définit le nombre d’éléments à afficher et la seconde définit chacun des éléments 
à afficher. 


Insérez le code suivant dans le fichier MasterViewController .m : 


1 

2 

3 

4 

5 

6 


- ( NSInteger ) tableView :( UITableView *) tableView 

number Of Rows InSection : (NSInteger) section 

{ 

return [maListe count] ; 

} 

- ( UITableViewCe 11 *) tableView :( UI Table View *) tableView 

cellForRowAtlndexPath : (NSIndexPath *) indexPath 
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7 

8 
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10 

11 

12 

13 


14 
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{ 

static MSString * Cellldentif ier = @"Cell"; 

UITableViewCell *cell = [tableView 

dequeueReusableCe HWi thl dent if ier : Cellldentifier] ; 
if (cell == nil) 

{ 

cell = [[UITableViewCell alloc] initWithStyle : 
UITableViewCell St yleDef ault reuseldentifier : 
Cellldentifier] ; 

} 

// Configure the cell. 

MSString *cellValue = [maListe ob j ect At Index : indexPat h . r ow] ; 
cell . textLabel . text = cellValue; 
return cell ; 


> 


Copier ce code 
^Code web : 160468 


Si vous essayez d’exécuter l’application, vous obtiendrez une erreur lors de la compila- 
tion. Il reste en effet plusieurs petits détails à régler avant que l’affichage des données 
dans le Table View soit opérationnel. 


Comme à la figure 14.12, cliquez sur MainStoryboard. storyboard dans le volet de 
navigation (1), affichez le volet des utilitaires en cliquant sur l’icône Hide or show 
the Utilities (2), affichez l’inspecteur des attributs en cliquant sur l’icône Show the 
Attributes inspector (3), cliquez sur le Table View dans le canevas (4) et choisissez 
Dynamic Prototypes dans la liste déroulante Content (5). 

Le contenu des cellules est en effet défini dans le code, ce qui correspond au modèle 
Dynamic Prototypes. 

Cette correction a produit un avertissement matérialisé par un triangle « attention » 
de couleur jaune dans la partie supérieure de la fenêtre de Xcode (1). Cliquez dessus 
pour prendre connaissance du problème, puis cliquez sur l’énoncé du problème dans 
la partie gauche de la fenêtre (2). Il ne vous reste plus qu’à donner un identifiant au 
prototype pour régler ce problème (3), comme indiqué à la figure 14.13. 

Juste histoire de souffler un peu, vous pouvez exécuter l’application en cliquant sur 
Run et constater que le Table View contient des données. 


Filtrage des données affichées dans le Table View 

Lorsque le contenu du contrôle Search Bar change, la méthode searchBar : searchBar 
textDidChange : searchText est exécutée. Nous allons donc utiliser cette méthode 
pour filtrer les données affichées dans le Table View. 

Mais avant de plonger dans le code, je vous rappelle que : 
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Figure 14.12 - Choisissez Dynamic Prototypes dans la liste déroulante Content 
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Figure 14.13 - Donnez un identifiant au prototype pour régler le problème 
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- les données affichées dans le Table View proviennent du NSMutableArray maListe; 

- le NSMutableArray maListe a été sauvegardé dans l’objet tampon à la fin de la 
méthode viewDidLoad. 


Ajoutez le code suivant dans le fichier MasterViewController .m : 


1 

2 

3 

4 

5 

6 

7 

8 
9 

10 

11 

12 

13 

14 

15 

16 

17 

18 

19 

20 
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- (void) searchBar : (UISearchBar ♦) searchBar t extD idChange : ( 
NSString *) searchText 

{ 

tampon2 = [[NSMutableArray alloc] init]; 

[tampon2 addOb j e et s Fr omAr ray : tampon] ; 

[maListe r emo ve AllOb j ec t s ] ; 
if ([searchText isEqualToSt r ing :<§""]) 

{ 

[maListe remo ve AllOb j ec t s ] ; 

[maListe addOb j ect sFromArray : tampon] ; // Restitution des 

données originales 
return ; 

} 

for(NSString *name in tampon2) 

{ 

NSRange r = [name rangeOf String : searchText ] ; 
if (r . location != NSNotFound) 

{ 

if (r . location== 0) 

[maListe addOb j ect : name ] ; 

} 

} 


> 


Ne vous laissez pas impressionner par la longueur de cette méthode ! Elle ne contient 
qu’un peu de logique élémentaire que nous allons facilement décortiquer. La ligne 3 
instancie l’objet tampon2. En d’autres termes, elle réserve la mémoire pour cet objet : 

l| tampon2 = [[NSMutableArray alloc] init]; 

La ligne 4 recopie le contenu de l’objet tampon dans l’objet tampon2 : 
l| [tampon2 addOb j e et s Fr omAr ray : tampon] ; 

La ligne 5 supprime le contenu de l’objet maListe : 
l| [maListe r emo ve Al 10b j ec t s ] ; 

Les instructions contenues dans le if suivant (lignes 6 à 11) sont exécutées lorsque la 
zone de recherche devient vide. Ce cas se produit lorsque l’utilisateur efface le texte 
qu’il a précédemment tapé. 

Lorsque la zone de recherche ne contient plus aucun texte, la liste originale doit être 
restaurée dans le Table View. Pour cela, on commence par effacer son contenu : 


Copier ce code 
Code web : 763064 
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l| [maListe remo ve Ail Ob j ect s ] ; 

Puis l’objet tampon (qui contient les données originales) est ensuite copié dans l’objet 
maListe : 

l| [maListe addObj ect sFromArray : tampon] ; 

Il n’est pas nécessaire d’exécuter les instructions suivantes. C’est pourquoi une instruc- 
tion return met fin à la méthode. 

L’instruction for de la ligne 13 passe en revue toutes les données contenues dans l’objet 
tampon2 : 

l| for(NSString *name in tampon2) 

La ligne 15 définit l’objet NSRange r et l’initialise avec la première occurrence du texte 
tapé dans la zone de recherche dans l’objet tampon2 : 

l| NSRange r = [name rangeOf String : searchText ] ; 

Si le texte tapé dans la zone de recherche fait partie de l’élément examiné dans tampon2 : 

l| if (r . location != NSNotFound) 

Et si ce texte se trouve au début de l’élément examiné : 

l| if (r . location== 0) 

L’élément trouvé est ajouté au NSMutableArray maListe : 

l| [maListe addObj ect : name ] ; 

La boucle for examine tour à tour tous les éléments de l’objet maListe. En fin de 
boucle, tous les éléments qui commencent par le texte tapé dans la zone de recherche 
sont donc copiés dans l’objet maListe. 

Après autant de lignes de code, vous brûlez certainement d’envie de lancer l’application. 
Cliquez sur Run et profitez de votre application. Vous l’avez bien mérité. 

Telle qu'elle a été implémentée dans cet exemple, la recherche est sensible à 
la casse des caractères. Ainsi par exemple, si vous tapez la lettre « I » dans 
la zone de recherche, aucun résultat ne sera affiché dans le Table View. Par 
contre, si vous tapez « L », les villes Lyon, Lille. Le Havre et Le Mans seront 
affichées. 



Copier le code 

\ 

^Code web : 457355 

J 


Gestion simultanée de deux vues sur un iPad 

Le modèle Master-Detail Application est particulièrement bien adapté aux iPad. 
Leur surface d’affichage, bien plus grande que celle offerte par les iPhone et iPod Touch, 
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permet aux applications basées sur ce modèle de rassembler deux vues : une liste et 
une vue détaillée de l’élément sélectionné dans la liste. L’application iPad Mail (figure 
14.14) est un parfait exemple d’utilisation de ce modèle. 



Figure 14.14 - L’application Mail sur iPad 

Et maintenant, passons sans plus attendre à la pratique. Définissez une nouvelle appli- 
cation basée sur le modèle Master-Detail Application, donnez-lui le nom « master- 
Detail » et choisissez iPad dans la liste déroulante Device Family. 

Cliquez sur MainStoryboard. storyboard dans le volet de navigation et observez les 
nombreux objets qui ont été créés, visibles à la figure 14.15. 

Comme vous pouvez le voir, l’application contient : 

- un contrôleur de vue Split View; 

- un contrôleur de navigation et un Table View liés au Master View Controller ; 

- un contrôleur de navigation et un contrôleur de vue détaillée. 

Exécutez l’application en cliquant sur l’icône Run. La figure 14.16 représente le résultat 
obtenu en mode portrait et en mode paysage. Pas si mal pour un début ! 

La vue Master consiste en un contrôle Table View. La vue Detail représente les détails 
de l’élément sélectionné dans la vue master. 

Je sens que vous avez envie de vous dégourdir les doigts. Ça tombe bien, nous allons 
personnaliser l’application qui vient d’être générée par Xcode pour qu’elle affiche trois 
éléments dans la liste et qu’un clic sur l’un d’entre eux provoque l’affichage d’une image 
et d’un texte dans la vue détaillée. À la figure 14.17 se trouve le résultat à obtenir. 

Pour arriver à ce résultat, voici les étapes à accomplir : 

1. suppression du texte affiché dans la vue détaillée au lancement de l’application ; 
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Figure 14.15 - De nombreux objets ont été créés 



Figure 14.16 - L’application en mode portrait et en mode paysage sur un iPad 
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Figure 14.17 - Notre application ressemblera à ça 


2. modification du texte affiché dans la barre d’outils ; 

3. définition des entrées textuelles du contrôle Table View; 

4. ajout de trois images dans les ressources de l’application et d’un contrôle Image 
View dans la vue détaillée ; 

5. dans la vue détaillée, affichage de l’image et du texte correspondant à l’entrée 
cliquée dans le contrôle Table View. 

Commençons par supprimer le texte affiché dans la vue détaillée au lancement de l’ap- 
plication. Cette étape est très simple : cliquez sur l’entrée MainStoryboard. storyboard 
dans le volet de naviga tion. R epérez le Label dans la vue Detail, cliquez dessus puis 
appuyez sur la touche ^Suppr J du clavier pour le supprimer. 

Nous allons maintenant modifier le texte affiché dans la barre d’outils. Cliquez sur 
DetailViewController .m dans le volet de navigation. Repérez la méthode suivante : 

1 splitViewController : willHideViewController : withBarButtonltem : 
f orPopo verCont r ol 1er : 

. . . et modifiez sa première instruction comme suit : 
l| barButtonltem . title = @"À vous de choisir"; 

Nous en sommes déjà à la troisième étape, à savoir, la définition des entrées affichées 
dans le contrôle Table View. Nous allons pour cela utiliser la méthode viewDidLoad 
du fichier MasterViewController .m. Cliquez sur ce fichier dans le volet de navigation 
et complétez la méthode viewDidLoad comme suit : 

1 - ( void ) viewDidLoad 

2 { 

3 laListe = [ [NSMutableArray alloc] init]; 

4 [laListe addObject: Q"Chat"]; 

5 [laListe addObject: @"Chien"]; 
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6 [laListe addObject: ©"Cheval"]; 

7 self . navigationltem . title = ©"Choisissez un animal"; 


9 [super viewDidLoad]; 

10 self . c lear s Select ionOnViewWi 11 Appear = NO; 

11 self . cont ent SizeForViewInPopo ver = CGSizeMake (320 . 0 , 600.0); 

12 } 


La première instruction initialise le NSMutableArray laListe : 
l| laListe = [[NSMutableArray alloc] init]; 

Les trois instructions suivantes ajoutent trois entrées dans le tableau laListe : 

1 [laListe addObject: ©"Chat"]; 

2 [laListe addObject: ©"Chien"]; 

3 [laListe addObject: ©"Cheval"]; 

Enfin, la dernière instruction ajoutée définit le titre qui sera affiché dans la fenêtre 
popup : 

l| self . navigationltem . title = ©"Choisissez un animal"; 

L’objet laListe a été initialisé dans la méthode viewDidLoad, mais il n’a pas été 
défini. Pour réparer cette lacune, cliquez sur MasterViewController .h dans le volet 
de navigation, puis ajoutez les lignes 2 à 4 sous la définition de l’interface : 

1 ©interface MasterViewController : UITableViewController 

2 { 

3 NSMutableArray ♦laListe; 

4 } 


Pour afficher les données dans le Table View, vous devez encore insérer deux méthodes 
dans le fichier MasterViewController .m : 


1 

2 

3 

4 

5 

6 

7 

8 
9 

10 

11 

12 

13 


- ( NSInt eger ) t ableView : ( UITableView *)tableView 

number Of Rows InSection : (NSInteger) section 

{ 

return [laListe count] ; 

} 

- (UITableViewCell *) t ableView :( UI Table View *)tableView 

cellForRowAt IndexPath : (NSIndexPath *) indexPath 

{ 

static NSString * My Ident if ier = © " My Ident if ier " ; 

UITableViewCell *cell = [tableView 

dequeueReusableCe HWit hldent if ier:MyIdentifier] ; 

if (cell == nil) 

cell = [[UITableViewCell alloc] initWithStyle : 

UITableViewCellStyleDef aul t reuseldentifier : Myldentifier 

] ; 
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14 







15 

// 
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cell ; 




19 

} 







ule 

ste objectAtlndex : indexPath . row] ; 
alue ; 


> 


Copier ce code 
^Code web : 196214 


Attention, si vous essayez d’exécuter l’application, vous obtiendrez une erreur lors de 
la compilation. Il reste en effet plusieurs petits détails à régler avant que l’affichage des 
données dans le Table View soit opérationnel : 


- le contenu des cellules étant défini dans le code, il faut utiliser un Dynamic Proto- 
types ; 

- un identifiant doit être affecté au prototype. 


Vous pouvez dès maintenant exécuter l’application et vérifier que le Table View affiche 
bien les trois cellules qui ont été renseignées. 


Maintenant, ajoutez trois images dans les ressources de l’application. Si vous voulez 
utiliser les mêmes images que moi, vous pouvez les télécharger en utilisant le code web 
suivant. 


D> 


Télécharger les images 
^Code web : 760903 


Ensuite, cliquez sur l’entrée MainStoryboard. storyboard dans le volet de navigation. 
Repérez la vue Detail et ajoutez-y un contrôle Image View et un contrôle Label. 
Redimensionnez et repositionnez ces contrôles afin d’obtenir quelque chose comme la 
figure 14.18. 


Définissez l’outlet unelmage pour le contrôle Image View et l’outlet laLegende pour 
le contrôle Label. Ces opérations doivent maintenant vous être familières. Au besoin, 
reportez-vous aux chapitres précédents pour avoir plus de détails sur la technique à 
utiliser. 


L’application est presque terminée : il ne reste plus que la cinquième étape, l’affichage de 
l’image et du texte qui correspondent à l’élément choisi par l’utilisateur dans le Table 
View. Avant tout, vous devez déterminer quel élément a été choisi par l’utilisateur 
en définissant la méthode didSelectRowAtlndexPath dans la vue Master. Cliquez sur 
MasterViewController .m et définissez la méthode didSelectRowAtlndexPath comme 
suit : 


1 - ( vo id ) t ableView : ( UITableView *) tableView 

didSelectRowAtlndexPath : (NSIndexPath *) indexPath 

2 { 

3 self . det ailViewCont r oller . det aill t em = [NSString 

stringWithFormat : 0"'/,0", [laListe objectAtlndex: indexPath 

. row] ] ; 

4 } 
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Detail 



Detail View Controller - Detail 


Figure 14.18 - Placez les contrôles comme ceci 
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L’unique instruction de cette méthode récupère l’élément choisi, le convertit en un 
NSString et le stocke dans la variable detailltem de la vue détaillée. 

Il ne reste plus qu’à récupérer la donnée passée dans la vue détaillée et à afficher 
l’image et le texte correspondants. Cela se fera dans la méthode conf igureView de la 
vue Detail. Cliquez sur DetailViewController .m dans le volet de navigation. Repérez 
la méthode conf igureView et complétez-la comme suit : 

1 - (void) conf igureView 

2 { 

3 self . laLegende . text = [self . detailltem description]; 

4 self . unelmage . image = [Ullmage imageNamed : [NSString 

s tr ingWithFormat : 0"'/, <8 '/, 8", [self, detailltem description] ,0". 
jpg"] ] ; 

5 } 

Cette méthode est également très courte. 

La ligne 3 récupère la chaîne stockée dans l’objet detailltem. Cette chaîne est affectée 
à la propriété texte du Label laLegende, ce qui provoque son affichage dans la vue 
détaillée. 

La ligne 4 vous semble peut-être un peu compliquée. Cela vient de l’imbrication de 
trois messages dans la deuxième partie de l’instruction. N’ayez crainte, il n’y a rien 
d’insurmontable dans cette instruction. Pour bien comprendre ce qui se passe, il faut 
toujours partir du message le plus interne. Ici : 

l| [self . detailltem description] 

Ce message a déjà été utilisé dans l’instruction précédente. Il renvoie la version texte 
du contenu de l’objet detailltem. Jusque-là, tout va bien ! 

Passons au message qui engloble [self . detailltem description] : 

1 [NSString s t r ingWithFormat : 0 " ‘/,0'/,0 ",[ self . de taillt em description 
] , 0" . jpg"] 

Ce message crée un objet NSString en concaténant la valeur sélectionnée par l’utilisa- 
teur et la chaîne « .jpg ». Supposons que l’utilisateur choisisse « chat » dans le Table 
View. Ce message produira un NSString contenant la chaîne « chat.jpg ». 

Passons enfin au troisième message : 

1 | [Ullmage imageNamed: . . .] 

Ce message définit un objet Ullmage en piochant dans les ressources de l’application. Le 
fichier sélectionné est précisément celui dont le nom a été calculé à l’étape précédente. 

Pour résumer, ces trois messages imbriqués fabriquent un objet Ullmage dont le nom 
est égal au contenu de la cellule sélectionnée par l’utilisateur, auquel on ajoute « .jpg ». 
Vous voyez, tout cela est très simple 

Ah oui, j’allais oublier l’essentiel : une fois l’objet Ullmage obtenu, il est affecté à la pro- 
priété image du contrôle Image View (self .unelmage . image = . . .). Ainsi, l’image 
est affichée dans la vue Detail. 
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Il ne vous reste plus qu’à cliquer sur Run et à profiter du résultat (figure 14.19). 



Figure 14.19 - L’application est terminée et fonctionne 
Vous pouvez copier les codes de l’application grâce au code web suivant. 


Copier ce code 

'N 

v Code web : 814981 

J 


En résumé 

- Les contrôles Tab Bar permettent de créer facilement des applications multivues. 
L’utilisateur passe d’une vue à l’autre en cliquant sur les icônes du contrôle Tab 
Bar, rattachés à la classe UITabBar. 

- Le modèle Master-Detail Application est particulièrement bien adapté aux iPad. 
Leur surface d’affichage, bien plus grande que celle des iPhone et iPod Touch, permet 
aux applications basées sur ce modèle de rassembler deux vues : une liste et une vue 
détaillée de l’élément sélectionné dans la liste. 

- Vous utiliserez un contrôle Tool Bar chaque fois qu’il est nécessaire d’ajouter une 
barre d’outils dans une application. Les contrôles Tool Bar relèvent de la classe 
UIToolBar. Ils peuvent être composés d’un ou de plusieurs boutons rattachés à la 
classe UIBarButtonltem. Ces boutons peuvent contenir du texte et/ou une image. 

- Le contrôle Search Bar est très pratique lorsqu’il est nécessaire d’effectuer une re- 
cherche dans une application. Ce contrôle relève de la classe UISearchBar. 
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Chapitre 

Insertion de contrôles avec le code 


15 


Difficulté : — 

P our insérer des contrôles dans une vue, la solution la plus immédiate consiste à 
utiliser Interface Builder. Si vous vous sentez l'âme codeuse, cette section devrait 
vous intéresser puisque nous allons voir comment insérer des contrôles dans une vue 
en utilisant le langage Objective-C. 

Les techniques exposées dans ce chapitre ont un autre avantage : elles permettent d'ajouter 
des contrôles pendant l'exécution de l'application. Cela peut s'avérer utile si vous devez 
créer une application qui s'adapte à son heure d'exécution, à la vitesse du device, ou à je 
ne sais quelle autre variable qu'il n'est pas possible de prévoir dans le storyboard. 
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Dans un premier temps, je vais vous donner un code complet, que vous pourrez copier 
grâce à un code web. Dans un second temps, je vais vous expliquer ce code. Il n’y aura 
rien de compliqué, rassurez-vous. 


Le code complet 


Définissez un nouveau projet basé sur le modèle Single View Application et donnez- 
lui le nom « defControles ». Cliquez sur defControlesViewController.nl dans le volet de 
navigation et complétez la méthode viewDidLoad comme suit : 


1 

2 

3 

4 

5 

6 

7 

8 
9 

10 

11 


12 

13 

14 

15 

16 

17 

18 

19 

20 
21 
22 

23 

24 

25 

26 

27 

28 

29 

30 

31 


- (void) viewDidLoad 

{ 

[super viewDidLoad]; 

//Ajout d'un Label 

CGRect rectLab = CGRectMake ( 10 , 10 , 100 , 20 ) ; // Définition d'un 

rectangle 

UILabel *monLabel = [[UILabel alloc] initWithFrame: rectLab]; 
monLabel . text = @"Ceci est un label"; 

[self . view addSubview : monLabel]; 

//Ajout d'un Round Rect Button 

UIButton *monBouton = [UIButton buttonWithType : 

UIBut t onTypeRoundedRec t ] ; 

monBouton . f rame = CGRectMake ( 10 , 40 , 100 , 20 ) ; 

[monBouton set Tit le : @ " Un bouton" forState: 

UlCont r ol St at eNormal ] ; 

[self . view addSubview: monBouton]; 

//Ajout d'un Text Field 

CGRect rectTF = CGRectMake ( 10 , 70 , 100 , 20 ) ; // Définition d'un 

rectangle 

UITextField *monChampTexte = [ [UIText Fie ld alloc] 

initWithFrame : rectTF] ; 

monChampTexte . borderStyle = UITextB order S t y leL ine ; 

[self . view addSubview: monChampTexte]; 

//Ajout d'un rectangle rouge 

CGRect rectangle = CGRectMake ( 10 , 100 , 100 , 100 ) ; // Définition 

d'un rectangle 

UlView *subview = [[UlView alloc] initWithFrame : rect angle ] ; 

// Ajout de la vue correspondante 
subview . backgroundColor = [UlColor redColor] ; 

[self . view addSubview : subview ] ; 

//Ajout d'un Image View 

Ullmage *img = [Ullmage imageWi thC ont ent s Of File : [[NSBundle 
mainBundle] pat hForRes our ce : @ " pet it chat " of Type : @ " j pg " ] ] ; 
CGRect cropRect = CGRectMake (0 , 0, 160, 240); 
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32 

33 

34 

35 

36 

37 


CGImageRef imageRef = CGImageCreat eWit hlmagelnRe et ( [ img 
CGImage] , cropRect) ; 

UlImageView *monImage = [[UlImageView alloc] initWithFrame : 

CGRectMake (150 , 10, 160, 240)]; 
monlmage . image = [Ullmage imageWithCGImage : imageRef ] ; 

[self. view addSubview : monlmage ] ; 

CGImageRelease ( imageRef ) ; 


> 


Pour terminer, définissez le groupe « Resources » dans l’arborescence de l’application et 
ajoutez-y une image de 160 x 240 pixels que vous nommerez « petitchat.jpg ». L’image 
que j’ai utilisée se trouve à la figure 15.1. 


Copier ce code 
Code web : 312856 



Figure 15.1 - « petitchat.jpg » 


j Télécharger l’image 

[ Code web : 303133 j 

Nous n’avons pas fait appel à Interface Builder et pourtant. . . Lancez l’application en 
cliquant sur l’icône Run. L’application représentée à la figure 15.2 se lance. 

Intéressant, non? 

Dans la suite de ce chapitre, je vais vous montrer ce qui se cache dans le code et 
pourquoi plusieurs contrôles apparaissent dans la vue de l’application. Le code est 
clairement découpé en plusieurs blocs indépendants. Chacun d’entre eux est responsable 
de l’affichage d’un contrôle dans la vue. 
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Figure 15.2 - Cette application a été créée uniquement avec du code 


Affichage d’un Label 

Je pense qu’arrivés à ce stade, vous savez tous à quoi ressemble un Label. Eh bien 
voici le code responsable de la définition et de l’affichage d’un Label : 

1 CGRect rectLab = CGRectMake ( 10 , 10 , 200 , 20 ) ; 

2 UILabel *monLabel = [[UILabel alloc] initWithFrame : rectLab]; 

3 monLabel . text = @"Ceci est un label"; 

4 [self . view addSubview : monLabel]; 

Avant de définir le Label, il est nécessaire de choisir son emplacement (10, 10) et ses 
dimensions (200,20). Ceci se fait en créant une structure de type CGRect : 

il CGRect rectLab = CGRectMake ( 10 , 10 , 200 , 20 ) ; 


Mais à quoi correspondent ces nombres? 


Le premier nombre correspond à l’abscisse du coin supérieur gauche du contrôle, le 
deuxième à l’ordonnée du coin supérieur gauche du contrôle, le troisième à la largeur 
du contrôle et le quatrième à la hauteur du contrôle. Regardez la figure 15.3, vous 
devriez comprendre. 
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AFFICHAGE D’UN LABEL 



Figure 15.3 - Correspondance des valeurs définies dans le code 


Le Label peut maintenant être défini. Nous lui donnons le nom rectLab et nous uti- 
lisons les coordonnées précisées dans la structure rectLab pour le positionner et le 
dimensionner : 

l| UILabel *monLabel = [[UILabel alloc] initWithFrame : rectLab]; 

Le texte affiché dans le Label est défini avec la propriété text : 
l| monLabel . text = @"Ceci est un label"; 

Il ne reste plus qu’à ajouter le label (addSubView: monLabel) à la vue courante 
(self .view) pour provoquer son affichage : 

l| [self. view addSubview: monLabel]; 

Dans cet exemple, la propriété text a été utilisée pour définir le texte affiché 
dans le Label. De nombreuses autres propriétés existent. Pour en avoir la 
liste, le plus simple consiste à faire appel à la documentation Apple. Vous 
pouvez vous aider de la figure 15.4 pour la marche à suivre : cliquez sur 
UILabel dans le code (1), affichez la section Aide rapide dans le volet 
des utilitaires en cliquant sur l'icône Show Quick Help (2), puis cliquez sur 
UILabel dans la section d'aide rapide (3). 
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Figure 15.4 - Affichage de la documentation d’Apple 

La fenêtre d’aide donne de très nombreuses informations. En particulier, elle liste les 
propriétés de la classe et leurs modes d’accès. 


Affichage d’un Round Rect Button 

Un Round Rect Button ressemble à la figure 15.5. 


Ceci est un Round Rect Button 


Figure 15.5 - Un Round Rect Button 

Et voici le code responsable de la définition et de l’affichage du Round Rect Button : 

1 UIButton ♦monBouton = [UIButton buttonWithType : 

UIBut t onTypeRoundedRect ] ; 

2 monBouton . f rame = CGRectMake ( 10 , 40 , 100 , 20 ) ; 

3 [monBouton setTitle : 0 "Un bouton" f or St at e : UIC ont r ol St at eNormal 

] ; 

4 [self . view addSubview : monBouton]; 

Dans un premier temps, l’objet UIButton monBouton est instancié : 

1 UIButton ♦monBouton = [UIButton buttonWithType: 

UIBut t onTypeRoundedRect ] ; 
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AFFICHAGE D’UN TEXT FIELD 


Son emplacement (10, 40) et sa taille (100, 20) sont alors définis, comme précédem- 
ment pour le Label. 

l| monBouton . f rame = CGRectMake ( 10 , 40 , 100 , 20 ) ; 

Le texte affiché dans le bouton à l’état « normal » (c’est-à-dire non pressé et non 
désactivé) est alors défini : 

1 [monBouton setTitle : @ "Un bouton" f or St at e : UI Cont r o ISt at eNormal 
] ; 

Puis le bouton est ajouté à la vue : 

l| [self. view addSubview : monBouton]; 

Plusieurs autres propriétés, telles que le type du bouton, la couleur du texte, l’image 
affichée dans le bouton, etc. sont accessibles dans le code. Vous en saurez plus en 
consultant la documentation Apple sur la classe UIButton. 

Affichage d’un Text Field 

Un Text Field ressemble à la figure 15.6. 


Figure 15.6 - Un Text Field 

Et voici le code responsable de la définition et de l’affichage de ce Text Field : 

1 CGRect rectTF = CGRectMake ( 10 , 70 , 100 , 20 ) ; // Définition d'un 

rectangle 

2 UITextField *monChampTexte = [ [UITextField alloc] initWithFrame 

: rectTF] ; 

3 monChampTexte . borderStyle = UITextBorderStyleLine ; 

4 [self. view addSubview: monChampTexte]; 

Dans un premier temps, la position (10, 70) et les dimensions (100, 20) de la zone 
de texte sont définies dans une structure CGRect : 

il CGRect rectTF = CGRectMake ( 10 , 70 , 100 , 20 ) ; 



Les paramètres de la fonction CGRectMake () sont les mêmes que dans les 
deux sous-parties précédentes, relatives aux contrôles Label et Round Rect 
Button. 


La zone de texte est alors instanciée : 


î 


[[UITextField alloc] initWithFrame 


UITextField ^monChampTexte 
: rectTF] ; 
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Pour qu’elle soit bien visible, on lui affecte une bordure : 
l| monChampTexte . borderStyle = UITextBorderStyleLine ; 

Puis la zone de texte est ajoutée à la vue : 
l| [self . view addSubview : monChampTexte]; 

Consultez la documentation Apple pour savoir quelles propriétés sont accessibles poul- 
ies contrôles UITextField. 


Affichage d’un rectangle de couleur rouge 

Voici le code qui permet de définir et d’afficher un rectangle 1 de couleur rouge : 

1 CGRect rectangle = CGRectMake ( 10 , 100 , 100 , 1 00 ) ; // Définition d' 

un rectangle 

2 UlView ♦subview = [[UlView alloc] initWithFrame : rectangle] ; // 

Ajout de la vue correspondante 

3 subview . backgroundColor = [UlColor redColor] ; 

4 [self . view addSubview : subview ] ; 

Dans un premier temps, la position (10, 100) et les dimensions (100, 100) du rec- 
tangle sont définies dans une structure CGRect : 

l| CGRect rectangle = CGRectMake ( 10 , 100 , 100 , 1 00 ) ; 

L’instruction suivante instancie un objet UlView dont les dimensions ont été spécifiées 
dans le CGRect rectangle : 

l| UlView ♦subview = [[UlView alloc] initWithFrame : rectangle] ; 

Pour que le rectangle soit bien visible dans la vue, nous lui affectons une couleur 
d’arrière-plan rouge en initialisant sa propriété backgroundColor : 

l| subview . backgroundColor = [UlColor redColor]; 

Il ne reste plus qu’à ajouter le rectangle à la vue courante : 
l| [self . view addSubview : subview ] ; 

Encore une fois, je vous invite à consulter la documentation Apple sur la classe UlView 
pour prendre connaissance des propriétés et méthodes utilisables. 


Affichage d’une image 

Voici le code permettant la définition et l’affichage d’une image : 


1. En l’occurrence, il s’agit d’un carré, mais ne chipotons pas. 
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AFFICHAGE D’UNE IMAGE 


1 Ullmage * img = [Ullmage imageWithCont ent s Of File : [[MSBundle 

mainBundle] pathForRe s our ce : @ " pet it chat " of Type : @ " j pg " ] ] ; 

2 CGRect cropRect = CGRectMake (0 , 0, 160, 240); 

3 CGImageRef imageRef = CGImageCreateWithlmagelnRect ( [img CGImage 

] , cropRect ) ; 

4 UlImageView ♦monlmage = [[UlImageView alloc] initWithFrame: 

CGRectMake (150 , 10, 160, 240)]; 

5 monlmage . image = [Ullmage imageWithCGImage : imageRef ] ; 

6 [self. view addSubview : monlmage] ; 

7 CGImageRelease ( imageRef ) ; 


j Copier ce code 
1 Code web : 569809 


L'image à afficher doit avoir été préalablement placée dans les ressources de 
l'application. Je ne vous dis pas comment faire, vous devriez le savoir. 

Le code utilisé pour afficher une image est légèrement plus complexe que les précédents. 
Ceci est dû au fait que l’affichage d’une image nécessite un plus grand nombre d’étapes. 

1. Création d’un objet Ullmage, puis stockage de l’image dans cet objet. 

2. Définition d’un objet UlImageView. 

3. Définition d’une structure CGImageRef pour regrouper les informations relatives 
à l’image. 

4. Affectation de l’objet CGImageRef à l’UIImageView. 

5. Ajout de l’Image View à la vue courante. 

La première instruction définit l’objet Ullmage img et l’initialise avec l’image « petit- 
chat .jpg » : 

1 Ullmage ♦img = [Ullmage imageWithCont ent s Of File : [[NSBundle 

mainBundle] pathForRe s our ce : @ " pet it chat " of Type : @ " j pg " ] ] ; 

Pour afficher une image, vous devez utiliser un Image View. L’instruction suivante 
définit l’objet UlImageView monlmage, ainsi que sa position (150, 10) et ses dimensions 
(160, 240) : 

1 UlImageView ♦monlmage = [[UlImageView alloc] initWithFrame: 
CGRectMake (150 , 10, 160, 240)]; 

Pour initialiser l’objet Image View qui vient d’être instancié, vous devez définir ses 
dimensions dans une structure CGRect : 

l| CGRect cropRect = CGRectMake (0 , 0, 160, 240); 

Puis utiliser ces dimensions et l’objet Ullmage précédemment créé pour définir une 
structure CGImageRef : 
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I CGImageRef imageRef = CGImageCr eat eWithlmage InRec t ( [ img CGImage 

] , cropRect ) ; 

II ne reste plus qu’à affecter la structure CGImageRef à la propriété image de l’Image 
View : 

l| monlmage . image = [Ullmage imageWithCGImage : imageRef ] ; 

Et à ajouter cet Image View à la vue courante : 
l| [self . view addSubview : monlmage ] ; 

La dernière instruction supprime l’objet CGImageRef de la mémoire. Une fois l’image 
affichée, celui-ci n’a en effet plus aucun intérêt : 

l| CGImageRelease ( imageRef ) ; 

Une fois encore, je vous invite à consulter la documentation Apple pour prendre connais- 
sance des propriétés des objets Ullmage et UlImageView, et donc pour avoir un aperçu 
de ce qu’il est possible de faire avec ces objets. 


En résumé 

Pour insérer des contrôles dans une vue, la solution la plus immédiate consiste à utiliser 
Interface Builder. Mais si vous vous sentez l’âme codeuse, vous pouvez utiliser du code 
pour parvenir au même résultat. Vous pouvez créer les contrôles suivants : 

- Label ; 

- Round Rect Button; 

- Text Field; 

- rectangles ; 

- Image View. 
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îhapitre 


16 


TP : Un navigateur Web très ciblé 


Difficulté : — 

C ette partie a été très riche et je suis sûr que vous avez fait de sérieux progrès en pro- 
grammation Objective-C. C'est pourquoi je vous propose de naviguer en solo (rassurez- 
vous, je ne serai pas très loin) pour créer une application à partir d'une idée et de rien 
d'autre ! 

Je ne sais pas si vous utilisez votre iPod Touch/iPhone/iPad pour naviguer sur le Web. 
Personnellement, cela m'arrive fréquemment, et je me rends compte que je vais toujours 
sur les mêmes sites. Pour faciliter l'accès à vos sites préférés, pourquoi ne pas créer une 
application dans laquelle il vous suffirait de cliquer sur un élément dans une liste pour 
accéder au site correspondant? 
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CHAPITRE 16. TP : UN NAVIGATEUR WEB TRES CIBLE 


Principe du TP 

Ce TP est tout à fait à votre portée si vous avez parcouru les chapitres de la troisième 
partie. Au besoin, n’hésitez pas à vous reporter à certains passages pour avoir des pistes 
lorsque vous développerez ce projet. 

Mais avant toute chose, je vous propose de vous montrer à quoi ressemblera notre 
application. Pour vous faire une idée, regardez la figure 16.1. 



Figure 16.1 - Voici à quoi ressemblera notre application 

Ça vous tente ? Alors, voici quelques conseils qui devraient bien débroussailler le terrain. 
Je vais volontairement être bref pour vous montrer que vous pouvez réaliser de grandes 
choses. . . facilement ! 

Bien sûr, il est tout à fait possible de créer cette application à partir du modèle Single 
View Application, mais il semble plus judicieux et plus facile d’utiliser le modèle 
Master-Detail Application. En effet, si le modèle Single View Application est 
en quelque sorte « universel », puisqu’il permet de réaliser toutes sortes d’applications, 
le modèle Master-Detail Application vous épargnera une partie du travail en pré- 
définissant les deux vues de l’application. Il vous suffira donc de les compléter en y 
ajoutant les contrôles et les contenus nécessaires. 

Vous serez amenés à créer une vue détaillée dans laquelle vous placerez un contrôle Web 
View. Pour que la vue principale communique l’adresse du site choisi par l’utilisateur à 
la vue détaillée, vous devrez créer une variable d’instance. Par exemple dans la classe 
de la vue détaillée, et vous arranger pour que la vue principale puisse accéder à cette 
variable. 

Et maintenant, c’est à vous de jouer! 
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CORRECTION 


Correction 

J’espère que vous n’avez pas eu trop de problèmes en développant cette application. Si 
vous n’avez rencontré aucune difficulté, je vous tire mon chapeau. Dans le cas contraire, 
je vous rassure, c’est tout à fait normal : le langage Objective-C est capricieux et les 
messages d’aide ne sont pas toujours explicites (du moins pour un néophyte). Il n’est 
pas rare de passer des heures sur une erreur qui, finalement, était tout autre que celle 
à laquelle on pensait de prime abord ! 

Je vais vous accompagner par étapes dans la correction de ce TP et vous verrez que ce 
n’était pas si complexe que ça. 


Définition de l’application et de la vue secondaire 

Définissez une nouvelle application de type Master-Detail Application et donnez-lui 
le nom « favoris ». Comme le montre le canevas MainStoryboard. storyboard (figure 
16.2), cette simple opération a créé une vue Master et une vue Detail. 



D»UII > 


- CM 






¥ 

i 

i 

1 

I 



Navigation Controller 


Master View Controller - Master 



Detail View Controller - Detail 






Figure 16.2 - Une vue Master et une vue Detail ont été automatiquement créées 


Définition des favoris 

Les sites favoris seront affichés dans la vue Master. Le but est d’obtenir le résultat 
visible à la figure 16.3. 

Voici les informations qui correspondent aux sites Web que j’ai choisis : 

- Google : http://www.google.fr 

- Le Site du Zéro : http://www.siteduzero.com 

- Mediaforma : http://www.mediaforma.com 

Bien entendu, rien ne vous empêche de choisir d’autres sites Web ou de compléter la 
liste comme vous l’entendez. 
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Figure 16.3 - Les sites favoris sont affichés dans la vue Master 


Les données de la vue Master seront directement définies dans le code. Cliquez sur 
MasterViewController .m dans le volet de navigation afin de compléter la méthode 
ViewDidLoad comme suit : 


1 

2 

3 

4 

5 

6 

7 

8 
9 

10 

11 

12 

13 

14 


- (void) ViewDidLoad 

{ 

[super ViewDidLoad]; 

mesFavoris = [[NSMutableArray alloc] init]; 

[mesFavoris addObject :@"Google"] ; 

[mesFavoris addOb j e et : @ " Le Site du Zéro"]; 

[mesFavoris addObject : @ " Medi af orma " ] ; 

self . navigationltem . title = @"Mes sites Web préférés"; 

adressesWeb = [ [NSMutableArray alloc] init]; 

[adressesWeb addObject : @ " ht tp : //www . google . fr"] ; 
[adressesWeb addObject : @ " ht tp : //www . s it eduzer o . com" ] ; 
[adressesWeb addObject : @ " ht tp : // www . mediaf orma . com" ] ; 


Le premier bloc d’instructions (lignes 4 à 8) définit les éléments qui seront affichés dans 
le contrôle Table View. Dans un premier temps, un espace mémoire est réservé pour 
l’objet NSMutableArray mesFavoris : 

il mesFavoris = [[NSMutableArray alloc] init]; 
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Les lignes 5 à 7 définissent les trois noms de sites affichés dans le Table View : 

1 [mesFavoris addOb j ect : © " Google "] ; 

2 [mesFavoris addOb j ect : © " Le Site du Zéro"]; 

3 [mesFavoris addOb j ect : © " Mediaf orma "] ; 

L’instruction de la ligne 8 définit le titre qui sera affiché dans la partie supérieure du 
Table View : 

l| self . navigationltem . title = ©"Mes sites Web préférés"; 

Le bloc d’instructions suivant (lignes 10 à 13) initialise un autre NSArray dans lequel 
seront stockées les adresses URL qui correspondent aux sites affichés dans le Table 
View. La première instruction réserve de l’espace en mémoire pour accueillir l’objet 
NSArray adressesWeb : 

l| adressesWeb = [[NSMutableArray alloc] init]; 

Les trois instructions suivantes définissent les adresses des trois sites favoris : 

1 [adressesWeb addOb j ect :©" ht tp :// www . google . f r "] ; 

2 [adressesWeb addOb j ect : © " ht tp : // www . s it eduzer o . com" ] ; 

3 [adressesWeb addOb j ect :©" ht tp : // www . mediaf orma . com" ] ; 

Pour que cette méthode fonctionne, vous devez déclarer les variables mesFavoris et 
adressesWeb dans le fichier d’en-têtes. Cliquez sur MasterViewController .h dans le 
volet de navigation et définissez les deux variables d’instance : 

1 # import <UIKit/UIKit.h> 

2 

3 ©interface MasterViewController : UITableViewCont r o lier 

4 { 

5 NSMutableArray ♦mesFavoris; 

6 NSMutableArray ♦adressesWeb; 

7 } 

8 

9 ©end 

Si vous avez des souvenirs du chapitre 11 consacré aux informations tabulaires (page 
197), vous savez que la définition du NSArray ne suffit pas. Vous devez également le 
relier au Table View pour que les données s’affichent. Pour cela, vous devez : 

1. indiquer que le contenu du Table View sera défini dans le code ; 

2. donner un nom au prototype des cellules ; 

3. indiquer au contrôle Table View combien de données il doit afficher; 

4. relier l’objet Table View et l’objet maListe. 

Pour indiquer que le contenu du Table View sera défini dans le code, cliquez sur 
MainStoryboard. storyboard dans le volet de navigation (1), comme indiqué à la 
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Figure 16.4 - Le contenu du Table View doit être défini dans le code 


figure 16.4. Cliquez sur le Table View dans le canevas (2), affichez le volet des utili- 
taires en cliquant sur Show or hide the Utilities (3), affichez l’inspecteur des at- 
tributs en cliquant sur Show the Attributes inspector (4) puis choisissez Dynamic 
Properties dans le paramètre Content (5). 

Pour donner un nom au prototype des cellules et ainsi éviter l’affichage d’un avertis- 
sement dans la barre d’outils de Xcode, cliquez sur la cellule affichée sous Prototype 
Cells dans le canevas (1) et renseignez la zone de texte Identifier (2), comme à la 
figure 16.5. 

Enfin, pour indiquer au contrôle Table View combien de données il doit afficher, et afin 
de relier les objets Tab View et maListe, définissez les méthodes numberOf RowslnSection 
et cellForRowAtlndexPath dans le fichier MasterViewController .m : 


1 
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- ( NSInteger ) tableView :( UITableView * ) t ableView 

number Of Rows InSection : (NSInteger) section 

{ 

return [mesFavoris count] ; 

} 

- (UITableViewCell *) t ableView :( UI Table View *) tableView 

cellForRowAtlndexPath : (NSIndexPath *) indexPath 

{ 

static NSString * CellI dent if ier = @ " My Ident if ier " ; 
UITableViewCell *cell = [tableView 
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Figure 16.5 - Il faut donner un nom au prototype des cellules afin d’éviter l’affichage 
d’un avertissement 


11 

12 


13 

14 

15 

16 

17 

18 
19 


dequeueReusableCe HWi thl dent if ier : Cellldentifier] ; 
if (cell == nil) { 

cell = [ [UITableViewCell alloc] initWithStyle : 

UITableViewCellStyleDef ault reuseldentif ier : 
Cellldentifier] ; 

} 

// Configuration des cellules 

NSString *cellValue = [mesFavoris obj e et At Index : indexPath . row 

] ; 

cell . textLabel . text = cellValue; 
return cell ; 


Si vous cliquez sur Run, la fenêtre du simulateur iOS affiche triomphalement vos sites 
favoris. 


Insertion du contrôle Web View et liaison au code 

Pour ceux qui auraient la mémoire courte, les contenus Web sont affichés 
dans des contrôles Web View. 

Cliquez sur MainStoryboard. storyboard dans le volet de navigation, cliquez sur 
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Detail view dans le canevas, supprimez le contrôle Label dans lequel apparaît le 
texte « Detail view content goes here » et remplacez-le par un contrôle Web View que 
vous redimensionnerez pour lui donner tout l’espace disponible dans la vue. 

Pour que le contrôle Web View puisse communiquer avec le code, vous allez définir 
un outlet. Dans la barre d’outils de Xcode, au-dessus du libellé Editor, cliquez sur 
l’icône Show the Assistant editor. Contrôle-glissez-déposez le contrôle Web View 
dans le fichier d’en-tétes DetailViewController .h, juste au-dessus du Oend final. Au 
relâchement du bouton gauche de la souris, donnez le nom « pageWeb » à l’outlet et 
validez en cliquant sur Connect. Le code du fichier d’en-tétes DetailViewController .h 
doit maintenant ressembler à ceci : 


1 

2 

3 

4 

5 

6 

7 
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# import CUIKit/UIKit .h> 

Sinterface DetailViewController : UlViewController 

Sproperty (strong, nonatomic) id detailltem; 

Oproperty (strong, nonatomic) IBOutlet UILabel * 
detailDescriptionLabel ; 

Sproperty (weak , nonatomic) IBOutlet UlWebView *pageWeb; 
8end 


Mise en relation des deux vues 

Vous allez maintenant relier la vue Master à la vue Detail. Comme d’habitude, cliquez 
sur MainStoryboard. storyboard dans le volet de navigation. Comme le montre la 
figure 16.6, cliquez sur l’élément qui représente une cellule dans la vue Master (1) puis 
contrôle-glissez-déposez cet élément sur la vue Detail (2). Au relâchement du bouton 
gauche de la souris, sélectionnez Push dans le menu (3). 

Pour pouvoir faire référence à cette liaison dans le code, vous allez lui donner un 
nom. Comme à la figure 16.7, cliquez sur le symbole qui identifie la liaison dans le 
canevas (1), sur l’icône Hide or show the Utilities dans la barre d’outils (2), sur 
Show the Attributes inspector dans le volet des utilitaires (3) puis donnez le nom 
« detailSegue » à la liaison (4). 


Partage de données entre les deux vues 

Lorsque l’utilisateur sélectionne un élément dans le contrôle Table View, la vue Detail 
remplace la vue Master. Pour passer des informations de la vue Master à la vue Detail, 
vous allez utiliser la méthode prepareForSegue. Pour cela, vous devez passer par une 
variable intermédiaire. Cliquez sur DetailViewController .h dans le volet de naviga- 
tion et définissez la propriété siteSelectionne comme suit : 

l| Sproperty (strong, nonatomic) id siteSelectionne; 
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Prototype Cells 



Detail 






Master View Controller - Master 



Figure 16.6 - Il faut relier la vue Master à la vue Detail 



Figure 16.7 - Il faut donner un nom à la liaison pour pouvoir y faire référence 
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Le fichier DetailViewController .h doit maintenant contenir les instructions sui- 
vantes : 


1 

2 

3 

4 

5 
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# import CUIKit/UIKit .h> 
©interface DetailViewController 


©property (strong, nonatomic 
©property (strong, nonatomic 
©property (strong, nonatomic 
detailDescriptionLabel ; 
©property (weak , nonatomic) 

©end 


: UlViewController 

) id detailltem; 

) id s it eSelect ionne ; 

) IBOutlet UILabel * 

IBOutlet UlWebView *pageWeb; 


Cliquez sur DetailViewController .m dans le volet de navigation et ajoutez une ins- 
truction synthesize pour pouvoir accéder à la propriété siteSelectionne : 

l| ©synthesize siteSelectionne = _ s ite Select ionne ; 

Ah, encore une petite chose : comme vous allez faire référence à la vue Detail dans la 
vue Master, vous devez également ajouter une instruction #import au début du fichier 
MasterViewController .m. Cliquez sur MasterViewController .m dans le volet de na- 
vigation et insérez l’instruction suivante, juste après l’instruction #import existante : 

l| #import " De t ai lViewCont r o lier . h" 

Vous pouvez maintenant insérer la méthode prepareForSegue. Si ce n’est pas déjà 
fait, cliquez sur MasterViewController .m dans le volet de navigation et insérez les 
instructions suivantes dans le code (peu importe l’endroit) : 

1 -( void ) prepareForSegue :( UI St oryboardSegue *)segue sender : (id) 

sender { 

2 if([[segue identifier] isEqualToSt r ing : © " det ailSegue " ] ) 

3 { 

4 NSInteger selectedlndex = [ [ self . tableView 

indexPathForSelectedRow] row] ; 

5 DetailViewController *dvc = [segue 

des t inat ionViewC ont r ol 1er ] ; 

6 dvc . s ite Select i onne = [NSString s tr ingWithFormat :©"'/,©" , [ 

adressesWeb objectAtlndex : selectedlndex] ] ; 

7 } 

8 } 

L’adresse du site sélectionné est mémorisée dans la variable d’instance siteSelectionne 
de la vue Detail (dvc . siteSelectionne). L’adresse est obtenue à partir du tableau 
adressesWeb, et plus précisément de la cellule dont l’index correspond à celui de la cel- 
lule sélectionnée ([adressesWeb objectAtIndex:selectedIndex]). L’élément obtenu 
est converti en un NSString avant d’être mémorisé dans la variable siteSelectionne 
([NSString str ingWithFormat : , ...) : 
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1 dvc . s it eSelect ionne = [NSString s t r ingWithFormat : © " */,© " , [ 

adressesWeb objectAtlndexiselectedlndex]] ; 

Vous devez enfin récupérer le site sélectionné dans DetailViewController .m et affi- 
cher la page correspondante. Cliquez sur DetailViewController .m dans le volet de 
navigation et complétez la méthode viewDidLoad comme ceci : 

1 [_pageWeb loadRequest : [NSURLRequest requestWithURL : [NSURL 
URLWithS t r ing : _s it e Se le et i onne ] ] ] ; 

Cette instruction demande l’affichage du site d’adresse siteSelectionne dans le contrôle 
Web View. 

Vous pouvez exécuter l’application en cliquant sur Run. Quelle réussite ! 

Les fichiers de cette application se trouvent dans le dossier favoris. Vous pouvez copier 
les codes de cette application grâce au code web suivant. 


Copier ce code 

i 

[Code web : 234496 

V 


MasterViewController .h 

1 # import <UIKit/UIKit.h> 

2 

3 ©interface MasterViewController : UITableViewCont r o lier 

4 { 

5 NSMutableArray ♦mesFavoris ; 

6 NSMutableArray ♦adressesïeb; 

7 } 

8 

9 ©end 

MasterViewController .m 
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# import "MasterViewController .h" 

# import "DetailViewController .h" 

© impie ment at ion MasterViewController 

- ( void ) awakeFr omNib 

{ 

[super awakeFr omNib ] ; 

} 

- ( vo id ) didRe cei veMemory Warning 

{ 

[super didReceiveMemoryïarning] ; 

// Release any cached data, images, etc that aren't in use. 

} 
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#pragma mark - View lifecycle 

- ( void) viewDidLoad 

{ 

[super viewDidLoad]; 

mesFavoris = [[NSMutableArray alloc] init]; 

[mesFavoris addObject :@"Google"] ; 

[mesFavoris addOb j e et : @ " Le Site du Zéro"]; 

[mesFavoris addObject : @ " Medi af orma " ] ; 

self . navigationltem . title = @"Mes sites Web préférés"; 

adressesWeb = [[NSMutableArray alloc] init]; 
[adressesWeb addObject : @ " ht tp : //www . google . fr"] ; 
[adressesWeb addObject : @ " ht tp : //www . s it eduzer o . com" ] ; 
[adressesWeb addObject : @ " ht tp : //www . mediaf orma . com" ] ; 


- ( NSInt eger ) t ableView : ( UITableView * ) t ableView 

number Of Rows InSection : (NSInteger) section 

{ 

return [mesFavoris count] ; 

} 

- (UITableViewCell *) t ableView :( UI Table View *) tableView 

cellForRowAt IndexPath : (NSIndexPath *) indexPath 

{ 

static NSString * CellI dent if ier = @ " My Ident if ier " ; 

UITableViewCell *cell = [tableView 

dequeueReusableCe HWit hldent if ier : Cellldentifier] ; 
if (cell == nil) { 

cell = [[UITableViewCell alloc] initWithStyle : 

UITable ViewCe 11S t y leDef aul t reuseldentif ier : 
Cellldentifier] ; 

} 

// Configuration des cellules 

NSString *cellValue = [mesFavoris ob j ectAt Index : indexPath . row 

] ; 

cell . textLabel . text = cellValue; 
return cell ; 


- ( void ) pr epar eFor Segue : ( UI St oryboardSegue *) segue sender : (id) 
sender { 

if ([[segue identifier] isEqualToSt r ing : @ " det ailSegue " ] ) 

{ 

NSInteger selectedlndex = [[ self . tableView 

indexPathForSelectedRow] row]; 
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DetailViewController *dvc = [segue 
de s t inat ionViewCont r o lier ] ; 

dvc . s it eSe lect ionne = [NSString s t r ingWithFormat : @ @ , [ 

adressesWeb objectAtlndex : selectedlndex]] ; 

} 

} 

- ( vo id ) viewDidUnload 

{ 

[super viewDidUnload]; 

// Release any retained subviews of the main view . 

// e.g. self . myOutlet = nil; 

} 

- (void)viewWillAppear:(B00L) an i mat ed 

{ 

[super viewWillAppear : animated] ; 

} 

- (void) viewDidAppear : (B00L) animated 

{ 

[super viewDidAppear : animated] ; 

} 

- (void)viewWillDisappear:(BOOL) animated 

{ 

[super viewWillDisappear : animated] ; 

} 

- (void) viewDidDisappear : (B00L) animated 

{ 

[super viewDidDisappear : animated] ; 

} 

- (B00L) shouldAutorotateToInterfaceûrientation : ( 

UI Interface Orientât ion) interface Orientât ion 

{ 

// Return YES for supported orientations 
return ( inter f aceOrientat ion != 

UIInterfaceOrientationPortraitUpsideDown) ; 

} 

®end 


îtailViewController .h 


# import CUIKit/UIKit .h> 

©interface DetailViewController : UI ViewC ont r ol 1er 
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5 Sproperty (strong, nonatomic) id detailltem; 

6 Sproperty (strong, nonatomic) id s it eSelect ionne ; 

7 Sproperty (strong, nonatomic) IBOutlet UILabel * 

detailDescriptionLabel ; 

8 Sproperty (weak , nonatomic) IBOutlet UlWebView *pageWeb; 

9 

10 ®end 

DetailViewController . m 


1 # import "DetailViewController. h" 

2 

3 ^interface DetailViewController () 

4 - ( void) c onf igure View ; 

5 ®end 

6 

7 @ implement at ion DetailViewController 
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®synthesize detailltem = _detailltem; 

®synthesize detailDescriptionLabel = _detailDes cript ionLabel ; 
®synthesize pageWeb = _pageWeb ; 

®synthesize siteSelectionne = _ s ite Select ionne ; 

#pragma mark - Managing the detail item 

- (void) setDetailltem: (id)newDetailItem 

{ 

if (_detailltem != newDetailltem) { 

_detailltem = newDetailltem; 

// Update the view. 

[self conf igureView] ; 

} 

} 

- ( void) c onf i gure View 

{ 

// Update the user interface for the detail item, 
if ( self . detailltem) { 

self . detailDescriptionLabel . text = [self . detailltem 
description] ; 

} 

} 

- ( void) didRecei veMemoryWarning 

{ 

[super didReceiveMemoryWarning] ; 

// Release any cached data, images , etc that aren't in use. 

} 
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#pragma mark - View lifecycle 

- ( void ) viewDidLoad 

{ 

[super viewDidLoad]; 

[self conf igureView] ; 

[_p a geWeb loadRequest : [NSURLRequest requestWithURL : [NSURL 
URLWithS t r ing : _s ite Select i onne ] ] ] ; 

} 

- ( void ) viewDidUnload 

{ 

[self setPageWeb : nil] ; 

[super viewDidUnload]; 

// Release any retained subviews of the main view . 

// e.g. self . myOutlet = nil; 

} 

- (void)viewWillAppear:(B00L) an i mat ed 

{ 

[super viewWillAppear : animated] ; 

} 

- (void) viewDidAppear : (B00L) animated 

{ 

[super viewDidAppear : animated] ; 

} 

- (void)viewWillDisappear:(B00L) animated 

{ 

[super viewWillDisappear : animated] ; 

} 

- (void) viewDidDisappear : (B00L) animated 

{ 

[super viewDidDisappear : animated] ; 

} 

- (B00L) shouldAutorotateToInterfaceûrientation : ( 

UI Interface Orientât ion) interface Orientât ion 

{ 

// Return YES for supported orientations 
return ( inter f aceOrientat ion != 

UIInterfaceOrientationPortraitUpsideDown) ; 

} 

Send 
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Aller plus loin 

Vous voulez aller plus loin ? Pas de problème, mais attention, cela sort du cadre de ce 
TP. Vous pourriez : 

1. autoriser l’ajout de sites via le clavier; 

2. permettre à l’utilisateur de mémoriser le site en cours de visualisation dans les 
favoris ; 

3. définir des favoris sur deux niveaux, en utilisant deux Table View; 

4. permettre une gestion avancée des favoris en autorisant (par exemple) les dépla- 
cements, suppressions et modifications de noms. 
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Plus loin avec iOS 5 
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îhapitre 


17 


Géolocalisation 


Difficulté : _ 

D ans ce chapitre, vous allez apprendre à utiliser quelques-unes des méthodes du fra- 
mework CoreLocation pour « géolocaliser » (c'est-à-dire obtenir la position) d'un 
iPhone, iPad ou iPod Touch. Vous apprendrez également à calculer la vitesse de dé- 
placement du device et à transformer un couple longitude/latitude en une adresse physique, 
bien plus parlante pour nous, pauvres humains. 
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Longitude et latitude 


Pour donner la position d’un point sur la Terre, on utilise souvent sa latitude et sa 
longitude. 

- Un parallèle est un cercle imaginaire parallèle à l’équateur. 

- La latitude est la distance mesurée en degrés qui sépare un parallèle de l’équateur. 

- Un méridien est un demi-cercle imaginaire qui relie les deux pôles. 

- Les méridiens de référence utilisés sont celui de Greenwich (longitude 0 ° ) et celui 
de l’observatoire de Paris (2 ° 20’14,025 à l’est du méridien de Greenwich). 

- La longitude est la distance mesurée en degrés qui sépare un méridien du méridien 
de référence. 

Si vous avez un peu de mal à vous représenter tout ça, je vous conseille de regarder la 
figure 17.1. 



Equateur 


Longitude 

30°Ouest 


.ongitude 

60°Est 


Latitude 60°Nord 


Latitude 30°Nord 


Longitude 

60°Ouest 


Méndien de 
Greenwich Longitude 
30° Est 


Latitude 30°S 


Figure 17.1 - La latitude et la longitude permettent de déterminer avec précision un 
point sur la Terre 


Ces quelques notions de base étant posées, nous allons définir une application qui 
renvoie la longitude et la latitude d’un device (iPhone, iPod Touch ou iPad 2). Les 
informations de géolocalisation utilisées pourront provenir de réseaux cellulaires, Wi- 
Fi et/ou GPS. Attaquons sans plus tarder. 

Commencez par définir un nouveau projet basé sur le modèle Single View Application 
et donnez-lui le nom « ouSuisJe ». Toutes les méthodes relatives à la géolocalisation se 
trouvant dans le framework CoreLocation, la première étape va consister à ajouter ce 
framework à l’application. 
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Comme à la figure 17.2, cliquez sur la première icône affichée dans le volet de navigation 
(1) et sélectionnez l’onglet Build Phases dans la zone d’édition (2). Développez l’entrée 
Link Binary With Libraries (3). Cliquez sur l’icône + (4), sélectionnez le framework 
CoreLocation. f ramework et cliquez sur Add (5). 



Figure 17.2 - Ajoutez le framework CoreLocation à l’application 


Nous allons afficher les coordonnées du device dans un Label. Pour ce faire, cliquez sur 
MainStoryboard. storyboard dans le volet de navigation (1) et ajoutez un Label à la 
vue de l’application (2), comme à la figure 17.3. Agrandissez ce contrôle et sélectionnez 
Show the Attributes inspector dans le volet des utilitaires (3). Affectez la valeur 
« Recherche de la position en cours » à la propriété Text (4) et la valeur « 10 » à la 
propriété Lines (5). 

Pourquoi affecter la valeur 10 à la propriété Lines du Label? 


Ce Label va être utilisé pour afficher des informations relatives à la position du device. 
La méthode utilisée pour obtenir ces informations est très « verbeuse ». C’est la raison 
pour laquelle autant de lignes sont attribuées au Label. Si vous limitez la taille du 
Label à deux ou trois lignes seulement, l’information affichée a toutes les chances 
d’être tronquée ! 

Cliquez sur l’icône Show the Assistant editor dans la barre d’outils. Contrôle-glissez- 
déposez le Label juste au-dessus du @end final et définissez l’outlet maPosition poul- 
ie Label. 
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Figure 17.3 - Nous allons afficher les coordonnées du device dans un Label 


Cliquez sur ViewController .h dans le volet de navigation et ajoutez une instruction 
#import au fichier d’en-têtes pour faire référence au framework CoreLocation : 


# import CUIKit/UIKit .h> 

# import < CoreLocation/ CoreLocation .h> 


Comme l’indique la documentation Apple, les informations de géolocalisation sont ob- 
tenues à travers la classe CLLocationManager. Cette dernière est accessible à travers 
le protocole CLLocationManagerDelegate. Vous allez donc devoir implémenter ce pro- 
tocole dans le code de l’application. 

Cliquez sur ViewController .h dans le volet de navigation et ajoutez le protocole dans 
la déclaration de l’interface : 

1 Sinterface ViewController : UlViewController < 
CLLocationManagerDelegate > 

Définissez ensuite la variable d’instance locationManager de classe CLLocationLManager : 

1 ^interface ViewController : UlViewController < 

CLLocationManagerDelegate > 

2 { 

3 CLLocationManager* locationManager; 

4 } 
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Comme nous le verrons un peu plus loin, c’est par l’intermédiaire de cette variable d’ins- 
tance que le processus de géolocalisation sera lancé. Le fichier d’en-têtes doit maintenant 
avoir l’allure suivante : 


1 

2 

3 

4 

5 

6 
7 


# import CUIKit/UIKit .h> 

# import <CoreLocation/CoreLocation .h> 

©interface ViewCont r oller : UlViewController < 
CLLocationManagerDelegate > 

{ 

CLLocationHanager* locationManager ; 

} 


9 

10 


©property (weak , nonatomic) IBOutlet UILabel *maPosition; 
©end 


Il est temps de passer à la définition du code. Cliquez sur ViewController .m dans le 
volet de navigation et complétez la méthode viewDidLoad comme suit : 

1 - ( void ) viewDidLoad 

2 { 

3 [super viewDidLoad]; 

4 locationManager = [ [CLLocationManager alloc] init]; 

5 if ([CLLocationManager lo cat ionServi cesEnabled] ) 

6 { 

7 locationManager . delegate = self; 

8 locationManager . desiredAccuracy = kCLLo cat ionAc cur acyBe s t ; 

9 locationManager . distanceFilter = 100. Of ; 

10 [locationManager startüpdatingLocation] ; 

11 } 

12 } 

N’ayez crainte, nous allons passer en revue toutes ces instructions. 

Ligne 4, l’objet locationManager est défini et initialisé : 
l| locationManager = [[CLLocationManager alloc] init]; 


Pour avoir de plus amples informations sur la classe CLLocationManager, 
consultez la documentation Apple. Le code web suivant vous permet d'y 
accéder directement. 


f Aller à la doc 

[ Code web : 570655 j 

L’instruction de la ligne 5 teste si le service de géolocalisation est disponible et activé : 
l| if ([CLLocationManager lo cat ionServi cesEnabled] ) { 

Cette instruction est nécessaire : en effet, si le mode « Avion » est activé ou si les 
périphériques de géolocalisation ne sont pas en mesure de fournir des informations, il 
est inutile de chercher à en obtenir. 
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L’instruction de la ligne 7 affecte la valeur self à la propriété delegate de l’ob- 
jet locationManager afin d’indiquer que les événements relatifs à la géolocalisation 
doivent être traités dans ViewController .m : 

l| locationManager . delegate = self; 

L’instruction de la ligne 8 définit la précision désirée : 

l| locationManager . desiredAccuracy = kCLLocationAccuracyBest ; 

La constante utilisée (kCLLocationAccuracyBest) demande la meilleure précision pos- 
sible. Si vous le souhaitez, vous pouvez utiliser une autre précision. Par exemple, 
kCLLocationAccuracyHundredMeters pour obtenir une précision de cent mètres. Consul- 
tez la section intitulée « Core Location Constants Reference » dans la documentation 
Apple pour prendre connaissance de toutes les constantes disponibles. 


Aller à la doc 

\ 

v Code web : 380969 

J 


Mais pourquoi ne pas utiliser systématiquement la meilleure précision pos- 
sible ? 

Cela semble en effet une bonne solution. . . si la batterie du device est entièrement 
chargée. Dans le cas contraire, la géolocalisation fonctionnera certes d’une façon très 
précise, mais pour une durée assez courte. En effet, précision et consommation en 
énergie vont de pair. À vous de trouver le juste milieu en fonction de ce que doit faire 
votre application. . . 

La ligne 9 définit la distance de déplacement minimale du device avant qu’une mise à 
jour de la position ne soit effectuée. Dans cet exemple, il faudra que le device se déplace 
de 100 mètres pour qu’une notification de changement de position soit faite : 

l| locationManager . distanceFilter = 100. Of; 

La ligne 10 exécute la méthode startUpdatingLocation. En d’autres termes, elle de- 
mande au device de mettre à jour de façon régulière ses coordonnées géographiques, en 
accord avec les paramètres définis précédemment (précision et déplacement minimum 
pour mise à jour) : 

l| [locationManager startUpdatingLocation]; 

L’implémentation du protocole CLLocationManagerDelegate et la définition de l’ob- 
jet locationManager ne sont pas suffisantes. Vous devez également faire appel aux 
méthodes : 

- locationManager :didUpdateToLocation:fromLocation: pour savoir si une nou- 
velle position est disponible ; 

locationManager : didFailWithError : qui indique, le cas échéant, qu’aucune posi- 
tion ne peut être déterminée pour le device. 
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Ces deux méthodes sont abondamment documentées dans la documentation Apple qui 
donne, entre autres choses, les en-têtes de ces deux fonctions. Ajoutez ces en-têtes dans 
le fichier ViewController .m et complétez-les comme suit : 


1 

2 

3 

4 

5 

6 

7 

8 
9 

10 

11 

12 


- ( void ) locat i onManager : ( CLLocat i onManager ♦) manager 
didUpdateToLocation : (CLLocation *) nesLocation 
fromLocation : (CLLocation * ) oldLocation 

{ 

maPosition . text = [newLocation description]; 

} 

- ( vo id ) locat i onManager :( CLLocat ionManager ♦) manager 
didFailWithError : (NSError *) error 

{ 

maPosition . text = [error description]; 

} 


Chaque fois qu’une mise à jour de la position du device est générée, la méthode 
locat ionManager :didUpdateToLocation:fromLocation: est exécutée. Le nouvel em- 
placement ([newLocation description]) est alors affiché dans le Label : 

l| maPosition . text = [newLocation description]; 

Lorsque le système de géolocalisation du device n’est pas en mesure de donner des co- 
ordonnées géographiques, la méthode locationManager : didFailWithError: est exé- 
cutée. Le message d’erreur ([error description];) est alors affiché dans le Label 
(maPosition. text) : 

l| maPosition . text = [error description]; 

Allez-y, lancez l’application, vous l’avez bien mérité ! 

Je suppose que vous testez cette application dans le simulateur iOS. Dans ce cas, une 
boîte de dialogue devrait s’afficher, comme à la figure 17.4. 

Validez en cliquant sur 0K. Regardez la figure 17.5, le résultat est plutôt fantaisiste. 
Pour avoir des résultats cohérents, une seule solution : testez l’application sur un device ! 
Le code de l’application se trouve dans le dossier ouSuisJe. 


(Copier ce 

code 

'N 

(Code web 

: 976860 

J 


ViewController .h 


1 

2 

3 

4 

5 

6 


# import CUIKit/UIKit .h> 

# import <CoreLocation/CoreLocation .h> 

©interface ViewController : UlViewController < 
CLLocationManagerDelegate > 

{ 


CLLocationHanager* locationManager ; 


305 


CHAPITRE 17. GÉOLOCALISATION 




Figure 17.4 - Une boîte de dialogue s’affiche dans le simulateur 



<♦37.78583400,- 122,40641 700> 
♦/- 5.00m (speed -1 .00 mps / 
cours© -1.00) @07/11/11 
17:1 1 :34 heure normale de 
l'Europe centrale 


□ 


L J 


Figure 17.5 - Le résultat de la géolocalisation est plutôt fantaisiste 
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} 

Sproperty (weak , nonatomic) IBOutlet UILabel *maPosition; 
@end 


îwController .m 

#import " V iewC ont r oller . h" 

Oimplementation ViewController 
Osynthesize maPosition; 

- ( vo id ) didRe cei veMemory Warning 

{ 

[super didReceiveMemoryWarning] ; 

// Release any cached data, images, etc that aren ' t in use. 

} 

#pragma mark - View lifecycle 

- ( vo id ) viewDidLoad 

{ 

[super viewDidLoad]; 

locationManager = [ [CLLocationManager alloc] init]; 

if ([CLLocationManager lo cat ionServi cesEnabled] ) { 

locationManager . delegate = self; 

locationManager . desiredAccuracy = kCLLo cat ionAc cur acyBe s t ; 
locationManager . distanceFilter = 1000. Of; 

[locationManager startUpdatingLocation] ; 

} 

} 

- (void) locationManager : (CLLocationManager manager 
didUpdateToLocation : (CLLocation * ) newLocation 
fromLocation : (CLLocation * ) oldLocation 

{ 

maPosition . text = [newLocation description]; 

} 

- (void) locationManager : (CLLocationManager ♦) manager 
didFailWithError : (NSError *) error 

{ 

maPosition . text = [error description]; 

} 

- ( void ) viewDidUnload 

{ 

[self setMaPosition : nil] ; 

[super viewDidUnload]; 

// Release any retained subviews of the main view . 
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44 

45 

46 

47 

48 

49 

50 

51 

52 

53 

54 

55 

56 

57 

58 

59 

60 
61 
62 

63 

64 

65 

66 

67 

68 

69 

70 

71 

72 

73 


// e.g. self . myOut let = nil ; 

} 

- (void) viewWill Appear : (BOOL) animated 

{ 

[super viewWillAppear : animated] ; 

} 

- (void) viewDidAppear : (BOOL) animated 

{ 

[super viewDidAppear : animated] ; 

} 

- (void) viewWillDis appear : (BOOL) animated 

{ 

[super viewWillDisappear : animated] ; 

} 

- (void) viewDidDisappear : (BOOL) animated 

{ 

[super viewDidDisappear : animated] ; 

} 

- (BOOL) shouldAutorotateTo Interface Orientât ion : ( 

UlInterfaceOrientation) interf aceOrientation 

{ 

// Return YES for supported orientations 
return ( int erf ace Or ient at ion ! = 

UIInterfaceOrientationPortraitUpsideDown) ; 

} 

®end 


Vitesse 


En utilisant le même principe que dans l’application précédente, et en y ajoutant la 
propriété speed de l’objet locationManager, il est possible d’obtenir la vitesse instan- 
tanée du device. 

Définissez un nouveau projet basé sur le modèle Single View Application et donnez- 
lui le nom « vitesse ». Ajoutez le framework CoreLocation dans ce projet et implémen- 
tez le protocole CLLocationManagerDelegate comme vous l’avez fait dans la section 
précédente. Insérez un Label dans la vue du projet et attachez-lui l’outlet laVitesse. 

Copiez-collez les en-têtes du fichier ViewController .h du projet ouSuisJe dans le 
fichier ViewController .h du projet vitesse. Voici ce que vous devriez obtenir : 


# import CUIKit/UIKit .h> 

# import < CoreLocation/ CoreLocation .h> 
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4 ©interface ViewController : UlViewController < 

CLLocationManagerDelegate > 

5 { 

6 CLLocationManager * locationManager ; 

7 } 

8 

9 ©property (weak , nonatomic) IBOutlet UILabel * laVitesse ; 
10 ©end 


Copiez-collez la méthode viewDidLoad du fichier ViewController .m du projet ouSuisJe 
dans le fichier ViewController .m du projet vitesse. 


1 

2 

3 

4 

5 

6 

7 

8 
9 

10 

11 

12 


- ( void ) viewDidLoad 

{ 

[super viewDidLoad]; 

locationManager = [[CLLocationManager alloc] init]; 
if ([CLLocationManager lo cat ionServi cesEnabled] ) 

{ 

locationManager . delegate = self; 

locationManager . desiredAccuracy = kCLLo cat ionAc cur acyBe s t ; 
locationManager . distanceFilter = 10. Of ; 

[locationManager startUpdatingLocation] ; 

} 


Copiez-collez la méthode locationManager : didUpdateToLocat ion: f romLocat ion: du 
fichier ViewController .m du projet ouSuisJe dans le fichier ViewController .m du 
projet vitesse, puis modifiez-la comme suit : 


1 

2 

3 

4 

5 

6 
7 


8 

9 

10 


- (void) locationManager : (CLLocationManager ♦) manager 
didUpdateToLocation : (CLLocation *) newLocation 
fromLocation : (CLLocation * ) oldLocation 
{ 

if (newLocation . speed > 0.0) 

{ 

NSString* vitesseString = [NSString stringWithFormat : © " 

Votre vitesse instantanée : ’/,0 . If m/s ", newLocation . speed 

] ; 

laVit es se . t ext = vitesseString; 

} 


Rappelons que cette méthode est exécutée chaque fois que le device change de position, 
en accord avec les paramètres de précision et de « distance de bougé » définis dans 
l’objet locationManager. 

Examinons les nouvelles instructions de cette méthode. 

La condition ligne 5 teste si la vitesse instantanée est supérieure à zéro, c’est-à-dire si 
le device est en mouvement : 

il if ( newLo cat ion . speed > 0.0) 
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Dans ce cas, la vitesse instantanée doit être affichée dans le Label laVitesse. Étant 
donné que la propriété speed est un nombre flottant et que la propriété text du Label 
est de type NSString, il est nécessaire d’effectuer une conversion de type. C’est le but 
de la première instruction qui suit le if : 

I NSString* vitesseString = [NSString s t r ingWithFormat : @ " Vot re 

vitesse instantanée : ’/,0.1f m/s ", newLocation . speed] ; 

Le NSString vitesseString est défini (NSString* vitesseString), puis il est initia- 
lisé avec un String ([NSString str ingWithFormat : . . . "] ) obtenu en concaténant 
une chaîne de caractères (« Votre vitesse instantanée : »), la vitesse instantanée flot- 
tante ('/.O. If) et une autre chaîne de caractères (« m/s »). 

II suffit maintenant d’afficher cette chaîne dans le label laVitesse en agissant sur sa 
propriété text : 

l| laVit es se . t ext = vitesseString; 

Modifiez également la propriété distanceFilter de l’objet locationManager et affectez- 
lui la valeur 10 . Of . 

Enfin, copiez-collez la méthode locationManager :didFailWithError: présente dans 
le fichier ViewController .m du projet ouSuisJe dans le fichier ViewController .m du 
projet vitesse, puis modifiez-la comme suit : 

1 - (void) locationManager : (CLLocationHanager *) manager 

2 didFailWithError : (NSError *)error 

3 { 

4 laVit es se . text = [error description]; 

5 } 

Il ne vous reste plus qu’à uploader ce projet sur votre device et à aller le tester sur le 
terrain. 

Ce projet se trouve dans le dossier vitesse. 


ViewController. h 


1 

2 

3 

4 


# import CUIKit/UIKit .h> 

# import <CoreL o cation/ CoreLo cation .h> 

^interface ViewController : UlViewController 
CLLocationManagerDelegate > 


5 { 

6 CLLocationHanager* locationManager; 

7 } 

8 

9 Sproperty (weak , nonatomic) IBOutlet UILabel 
10 Oend 

ViewController. m 


< 


*laVitesse; 
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#import " V iewC ont r oller . h" 

@ implement at i on ViewController 
Osynthesize laVitesse; 

- ( void ) di dRe ce i veMemory Warning 

{ 

[super didReceiveMemoryWarning] ; 

// Release any cached data, images, etc that aren ' t in use. 

} 

#pragma mark - View lifecycle 

- ( vo id ) viewDidLoad 

{ 

[super viewDidLoad]; 

locationManager = [ [CLLocationManager alloc] init]; 

if ([CLLocationManager lo cat ionServi cesEnabled] ) { 

locationManager . delegate = self; 

locationManager . desiredAccuracy = kCLLo cat ionAc cur acyBe s t ; 
locationManager . distanceFilter = 10. Of ; 

[locationManager startUpdatingLocation] ; 

} 

} 

- (void) locationManager : (CLLocationManager ♦) manager 
didUpdateToLocation : (CLLocation *) newLocation 
fromLocation : (CLLocation * ) oldLocation 

{ 

if (newLocation . speed > 0.0) 

{ 

NSString* vitesseString = [NSString stringWithFormat : @ " 

Votre vitesse instantanée : ’/,0 . If m/s ", newLocation . speed 

] ; 

laVit es se . t ext = vitesseString; 

} 

} 

- (void) locationManager : (CLLocationManager ♦) manager 
didFailWithError : (NSError * ) error 

{ 

laVitesse . text = [error description]; 

} 

- ( void ) viewDidUnload 

{ 

[self setLaVitesse : nil] ; 

[super viewDidUnload]; 

// Release any retained subviews of the main view . 

// e.g. self . myOutlet = nil; 
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} 

- (void) viewWill Appear : (B00L) animated 

{ 

[super viewWillAppear : animated] ; 

} 

- (void) viewDidAppear : (B00L) animated 

{ 

[super viewDidAppear : animated] ; 

} 

- (void) viewWillDis appear : (B00L) animated 

{ 

[super viewWillDisappear : animated] ; 

} 

- (void) viewDidDisappear : (B00L) animated 

{ 

[super viewDidDisappear : animated] ; 

} 

- (B00L) shouldAutorotateTo Interface Orientât ion : ( 

UlInterfaceOrientation) interf aceOrientation 

{ 

// Return YES for supported orientations 
return ( int erf ace Or ient at ion ! = 

UIInterfaceOrientationPortraitUpsideDown) ; 

} 


®end 


Copier ce code 

'N 

[Code web : 893789 

J 


Géolocalisation inversée 


Le processus de « géolocalisation inversée » consiste à trouver l’adresse qui correspond 
à un couple longitude/latitude. Le framework MapKit donne accès à une classe de 
géolocalisation inversée liée à Google Maps. 

Le principe en est détaillé ci-après. 

1. Implémentation du protocole CLLocationManagerDelegate, définition de l’objet 
locationManager et utilisation de la méthode 
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l| - locationManager : didUpdateToLocation: fromLocation: 

pour obtenir la position du device. Cette technique a été décrite dans la première 
section de ce chapitre. 


GÉOLOCALISATION INVERSÉE 


2. Implémentation du protocole MKReverseGeocoderDelegate et utilisation des co- 
ordonnées locales obtenues dans l’étape 1 pour trouver l’adresse correspondante 
via la méthode 

l| - reverseGeocoder : geocoder didFindPlacemark : placemark 

3. Affichage de l’adresse dans un contrôle UITextView déposé dans la vue de l’ap- 
plication. 

Commencez par définir une nouvelle application basée sur le modèle Single View 
Application et donnez-lui le nom « geolocalisationlnverse ». Cette application va uti- 
liser les frameworks CoreLocation (pour trouver la longitude et la latitude du device) 
et MapKit (pour effectuer la géolocalisation inversée). La première étape va donc consis- 
ter à ajouter ces frameworks à l’application. 

1. Cliquez sur la première icône affichée dans le volet de navigation. 

2. Sélectionnez l’onglet Build Phases dans la zone d’édition. 

3. Développez l’entrée Link Binary With Libraries. 

4. Cliquez sur l’icône +, sélectionnez le framework CoreLocation. framework et cli- 
quez sur Add. 

5. Cliquez sur l’icône +, sélectionnez le framework MapKit . framework et cliquez sur 
Add. 


Cliquez sur MainStoryboard. storyboard dans le volet de navigation et ajoutez un 
contrôle UITextView à la vue de l’application. Cliquez sur l’icône Show the Assistant 
editor dans la barre d’outils et contrôle-glissez-déposez le contrôle de la zone d’édition 
dans le fichier d’en-têtes, juste au-dessus du @end final. Définissez l’outlet ladresse 
pour ce contrôle. 

Vous allez maintenant modifier le fichier d’en-têtes. Ajoutez deux instructions #import 
pour accéder aux framework MapKit et CoreLocation : 


1 

2 

3 

4 


# import CUIKit/UIKit .h> 

#import <MapKit /MapKit . h> 

# import <CoreLocation/CoreLocation .h> 


Ajoutez les protocoles MKReverseGeocoderDelegate et CLLocationManagerDelegate 
dans la définition de l’interface et définissez la variable d’instance locationManager 
de type CLLocationManager : 

1 ©interface geo lo calis at ionlnver s eViewCont r ol 1er : 

UI ViewC ont r ol 1er <MKReverseGeocoderDelegate , 
CLLocationManagerDelegate > 

2 { 

3 CLLocationManager* locationManager; 

4 } 


Le fichier ViewController .h doit maintenant avoir l’allure suivante : 
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# import CUIKit/UIKit .h> 

#import <MapKit /MapKit . h> 

# import <CoreL o cation/ CoreLo cation .h> 

©interface ViewController : UlViewController < 

MKReverseGeocoderDelegate , CLLocationManagerDelegate > 

{ 

CLLo cat ionManager * locationManager ; 

} 

©property (weak , nonatomic) IBOutlet UITextView ♦ladresse ; 
©end 



Vous avez peut-être remarqué le panneau « Attention » de couleur jaune af- 
fiché dans la marge gauche du code (figure 17.6). Si vous cliquez dessus, un 
message vous indique que MKReverseGeocoderDelegate est « deprecated » 
(c'est-à-dire obsolète en bon français). Que cela ne vous effraie pas : ce de- 
legate est toujours utilisable et entièrement fonctionnel. Il se peut cependant 
qu'il soit remplacé dans la version 6 d'iOS. Je vous conseille donc d'ignorer 
cet avertissement. 


^interface V|iewCont roller : UlViewController «MKReverseGeocoderDelegate, 
CLLocat ionManaaerDe leqate> 


'MKReverseGeocoderDelegate* is deprecated 


Figure 17.6 - Un panneau « Attention » de couleur jaune est affiché dans la marge 
gauche du code 


Vous allez maintenant modifier le code de l’application. Cliquez sur ViewController .m. 
Votre première action va consister à lancer une géolocalisation en agissant sur la mé- 
thode viewDidLoad : 


1 

2 

3 

4 

5 

6 

7 

8 
9 

10 

11 


- (void) viewDidLoad 

{ 

locationManager = [ [CLLocationManager alloc] init]; 

if ([CLLocationManager locat i onSer vicesEnabled] ) { 

locationManager . delegate = self; 

locationManager . desiredAccuracy = kCLLocationAccuracyBest ; 
locationManager . distanceFilter = 10. Of ; 

[locationManager s t artüpdat ingLo cat ion] ; 

} 

[super viewDidLoad]; 


Ici encore, plusieurs signes « Attention » apparaissent dans la marge gauche 
du code. Ignorez-les : les méthodes et objets concernés sont totalement fonc- 
tionnels avec iOS 5. 
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Jusqu’ici, rien de nouveau. Si nécessaire, reportez-vous à la première section de ce cha- 
pitre pour avoir des explications détaillées sur ce code. Si une erreur se produit pendant 
la tentative de géolocalisation, la méthode locationManager:didFailWithError est 
exécutée. Le message d’erreur correspondant ([error description]) est alors affiché 
dans le TextView (ladresse . text) : 

1 - ( void ) locat i onManager : ( CLLocat ionManager ♦) manager 

2 didFailWithError : (NSError *) error 

3 { 

4 ladresse . text = [error description]; 

5 } 

Si la position du device est identifiée, la méthode 

l| - locat ionManager : didUpdateToLo cat ion : f romLocat ion : 

est exécutée. Définissez cette méthode et complétez-la comme suit : 

1 - ( void ) locat i onManager :( CLLocat ionManager ♦) manager 

2 didUpdateToLocation : ( CLLocation *) newLocation 

3 fromLocation : (CLLocation *) oldLocation 

4 { 

5 MKReverseGeocoder * geocoder = [ [MKReverseGeocoder alloc] 

initWithCoordinate : newLocation. coordinate] ; 

6 geocoder . delegate = self ; 

7 [geocoder start] ; 

8 } 

Cette méthode définit l’objet geocoder de type MKReverseGeocoder et l’initialise avec 
les coordonnées géographiques retournées à la méthode didüpdateTo : 

1 MKReverseGeocoder * geocoder = [[MKReverseGeocoder alloc] 
initWithCoordinate : newLocation . coordinate] ; 

L’instruction suivante indique que la gestion des événements (delegate) liés à l’objet 
geocoder (c’est-à-dire à la géolocalisation inversée) se fera dans la classe courante : 

l| geocoder . delegate = self; 

Enfin, la dernière instruction lance le processus de géolocalisation inversée : 
l| [geocoder start]; 

Si une erreur se produit pendant le processus de géolocalisation inversée, la méthode 
reverseGeocoder : didFailWithError est exécutée. Le message d’erreur correspon- 
dant ([error description]) est alors affiché dans le TextView (ladresse . text) : 

1 - (void) reverseGeocoder: (MKReverseGeocoder^) geocoder 

didFailWithError : (NSError *) error 

2 { 

3 ladresse . text = [error description]; 

4 } 
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Si une adresse a pu être associée au couple longitude/latitude du device, la méthode 
reverseGeocoder : didFindPlacemark est exécutée. Complétez cette méthode comme 
suit : 

1 - ( void) re ver seGeoc oder : ( MKRe ver seGeoc oder * ) geocoder 

didFindPlacemark : (MKPlacemark *) placemark 

2 { 

3 ladresse . text = [placemark . addres sDi et ionar y description]; 

4 } 

L’unique instruction de cette méthode affiche l’adresse complète dans le contrôle TextView. 

Il ne vous reste plus qu’à uploader cette application sur votre device et à la tester en 
vous baladant près de chez vous. Vous devriez obtenir quelque chose comme la figure 
17.7. 



Opérateur <? 11:51 f O 


< 

City = “San Francisco*; 

Country = ■\U00c9iats-LHiis" 

CountryCoôe = US 
FormanedAddressUnes = ( 

“1 Stockton Sf. 

“San Francisco. Californie 94108*. 
"VUOOc9tats-Unis' 

); 

State = Californie; 

Street = *1 Stockton St"; 
SubAdmlnistrativeArea = “San Francisco"; 
SubThorougnfare ■ 1 ; 

Thoroughfare = "Stoddon SF; 

ZIP «94108; 



Figure 17.7 - Résultat de la géolocalisation inversée 


Le code de l’application se trouve dans le dossier geolocalisationlnverse. 


Copier ce code 

\ 

v Code web : 292862 

J 


ViewController .h 

1 # import <UIKit/UIKit.h> 

2 #import <MapKit /MapKit . h> 
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3 

4 

5 

6 

7 

8 
9 

10 

11 

12 


# import <CoreLocation/CoreLocation .h> 

^interface ViewController : UlViewController < 

MKReverseGeocoderDelegate , CLL ocat ionManagerDelegat e > 

{ 

CLLocationManager * locationManager ; 

} 

(Sproperty (weak , nonatomic) IBOutlet UITextView *ladresse; 
@end 


ViewController .m 


1 

2 

3 

4 

5 

6 

7 

8 
9 

10 

11 

12 

13 

14 

15 

16 

17 

18 

19 

20 
21 
22 

23 

24 

25 

26 

27 

28 

29 

30 

31 

32 

33 

34 

35 

36 


#import "ViewController . h" 

Simplementation ViewController 
Osynthesize ladresse; 

- ( vo id ) didRe cei veMemory Warning 

{ 

[super didReceiveMemoryWarning] ; 

// Release any cached data, images, etc that aren ' t in use. 

} 

#pragma mark - View lifecycle 

- ( void ) viewDidLoad 

{ 

[super viewDidLoad]; 

locationManager = [[CLLocationManager alloc] init]; 
if ([CLLocationManager lo cat ionServi cesEnabled] ) { 

locationManager . delegate = self; 

locationManager . desiredAccuracy = kCLLo cat ionAc cur acyBe s t ; 
locationManager . distanceFilter = 10. Of ; 

[locationManager startUpdatingLocation] ; 

} 

} 

- (void) locationManager : (CLLocationManager ♦) manager 
didFailWithError : (NSError * ) error 

{ 

ladresse . text = [error description]; 

} 


- (void) locationManager : (CLLocationManager ♦) manager 
didUpdateToLocation : (CLLocation *) newLocation 
fromLocation : (CLLocation * ) oldLocation 
{ 

MKReverseGeocoder * geocoder = [ [MKReverseGeocoder alloc] 
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initWithCoordinate : newL o cation . coordinate] ; 
geocoder . delegate = self; 

[geocoder start] ; 

} 

- ( void) re ver seGeoc oder : ( MKRe ver seGeoc oder * ) geocoder 

didFindPlacemark : (MKPlacemark *) placemark 

{ 

ladresse . text = [placemark . addres sDi et ionar y description]; 

} 

- (void) viewDidUnload 

{ 

[self setLadresse : nil] ; 

[super viewDidUnload]; 

// Release any retained subviews of the main view . 

// e.g. self . myOut let = nil; 

} 

- (void) viewWill Appear : (B00L) animated 

{ 

[super viewWillAppear : animated] ; 

} 

- (void) viewDidAppear : (B00L) animated 

{ 

[super viewDidAppear : animated] ; 

} 

- (void) viewWillDis appear : (B00L) animated 

{ 

[super viewWillDisappear : animated] ; 

} 

- (void) viewDidDisappear : (B00L) animated 

{ 

[super viewDidDisappear : animated] ; 

} 

- (B00L) shouldAutorotateTo Interface Orientât ion : ( 

UlInterfaceOrientation) interf aceOrientation 

{ 

// Return YES for supported orientations 
return ( int erf ace Or ient at ion ! = 

UIInterfaceOrientationPortraitUpsideDown) ; 

} 


®end 
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En résumé 

- Le framework CoreLocation permet de géolocaliser un device, mais aussi de calculer 
la vitesse de déplacement du device et de transformer un couple longitude/latitude 
en une adresse physique. 

- Pour géolocaliser un device, vérifiez que le service de géolocalisation est disponible 
et activé, paramétrez la précision et mettez à jour les données de géolocalisation. 

- Pour calculer la vitesse instantanée d’un device, utilisez le principe de la géolocali- 
sation et ajoutez-y la propriété speed de l’objet locationManager. 

- Le processus de « géolocalisation inversée » consiste à trouver l’adresse qui correspond 
à un couple longitude/latitude. Le framework MapKit donne accès à une classe de 
géolocalisation inversée liée à Google Maps. Pour l’utiliser, vous définirez un objet 
de classe MKReverseGeocoder et vous lui appliquerez la méthode start. 
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îhapitre 


18 


ultimédia : le son 


Difficulté : — 

L es devices Apple sont en mesure de jouer et d'enregistrer des sons. Vous utilisez certai- 
nement l'application iPod pour écouter vos albums préférés et l'application Dictaphone 
pour prendre des notes vocales. Que diriez-vous d'accéder à ces possibilités dans vos 
propres applications? C'est ce que vous allez découvrir dans ce chapitre. Vous devez penser 
que le code à utiliser est compliqué et que vous n'avez pas (encore) le niveau nécessaire ! 

Je vous rappelle que vous êtes maintenant dans la quatrième partie de ce tutoriel et que vous 
avez appris énormément de choses dans les trois parties précédentes. Dans ce chapitre, vous 
allez relever un nouveau défi, et je vous assure que vous vous en sortirez honorablement ! 

Alors commençons sans plus attendre. . . 
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Jouer des éléments audio 

Plusieurs techniques permettent de jouer des sons sur un device. La plus simple consiste 
à passer par les « System Sound Services » du framework AudioToolbox. Une technique, 
plus complexe, consiste à utiliser un AVAudioPlayer. 

Je vais vous montrer comment utiliser ces deux techniques. À vous de choisir celle qui 
est le mieux adaptée aux applications que vous voulez réaliser. 

La technique « System Sound Services » 

Cette technique est particulièrement bien adaptée aux sons utilisés dans l’interface 
utilisateur d’une application : quand vous appuyez sur un bouton ou quand vous vous 
déplacez dans un contrôle par exemple. 

Il y a cependant quelques restrictions. 

1. Les sons doivent avoir une durée maximale de 30 secondes. 

2. Seuls quelques codées audio sont supportés : 

- AMR (Adaptive Multi-Rate) ; 

- iLBC (internet Low Bitrate Codée) ; 

- IMA/ADPCM (IMA-4) ; 

- Linear PCM ; 

- /rLaw and aLaw. 


Codée? Qu'est-ce encore que cela ? 


Codée est l’abréviation de « codeur/décodeur ». Les fichiers audio sont généralement 
compressés pour réduire leur taille. Le format de compression (le codée) utilisé dépend 
de l’application dans laquelle le fichier audio est créé. Pour qu’il puisse être joué sur 
une machine donnée (un Mac, un PC, un iPhone, etc.), il faut que ce dernier dispose 
du décodeur correspondant. Les iPhone/iPod Touch/iPad disposent des codées cités 
plus haut. 

Si un fichier audio utilise un codée non reconnu, il ne sera pas joué sur le device. Pour 
éviter ce désagrément, je vous conseille de convertir vos sons au format CAF en utilisant 
le programme afeonvert sur votre Mac. 

Cliquez sur l’icône Applications dans le Dock, ouvrez le dossier Utilitaires puis 
cliquez sur l’icône Terminal. Déplacez-vous dans le dossier qui contient le fichier à 
convertir. Supposons que vous vouliez convertir le fichier 22-new.aif en 22-new.caf ; 
vous taperez quelque chose comme ceci : 


afeonvert -f caff -d LEI16@44100 22-new.aif 22-new.caf 



322 


JOUER DES ELEMENTS AUDIO 



Ça me semble plutôt indigeste comme commande. Pourrais-je avoir quelques 
explications ? 


Vous avez raison : la commande af convert n’est pas très « sexy ». Mais quelle efficacité ! 
Elle permet de convertir à peu près tous les formats de fichiers audio en une seule ligne. 
Pour avoir toutes les informations nécessaires à l’utilisation de cette commande, tapez 
af convert -h. dans la fenêtre Terminal. 

À titre d’information, sachez que le paramètre LEI 16044100 demande une conversion 
sur 16 bits avec un échantillonnage en 44100 Hz. Plus ces deux valeurs (16 et 44100) 
sont élevées, meilleur est le son obtenu. Mais aussi, plus grande est la taille du fichier. 
Faites quelques essais en utilisant une conversion sur 8, 16 et 24 bits en 11025, 22050 et 
44100 Hz. Ce qui donne des paramètres compris entre LEI8@11025 et LEI24@44100. 
À vous de juger quel est le meilleur compromis entre la qualité sonore et la taille du 
fichier obtenu. 


Voyons par la pratique comment utiliser les « System Sound Services » du framework 
AudioToolbox. Nous allons travailler sur un fichier audio nommé Applaudissements . caf . 


> 


Télécharger 

applaudissements . caf 
.Code web : 973650 


Créez une nouvelle application basée sur le modèle Single View Application et 
donnez-lui le nom « ecouteAudio » . 


Toutes les méthodes relatives aux « System Sound Services » se trouvent dans le fra- 
mework AudioToolbox. La première étape va donc consister à ajouter ce framework à 
l’application. Pour cela, suivez les instructions visibles à la figure 18.1. 


1. Cliquez sur la première icône affichée dans le volet de navigation. 

2. Sélectionnez l’onglet Build Phases dans la zone d’édition. 

3. Développez l’entrée Link Binary With Libraries. 

4. Cliquez sur l’icône +. 

5. Sélectionnez AudioToolbox . framework dans la boîte de dialogue. 

6. Cliquez sur Add pour ajouter le framework au projet. 


Pour jouer un son, vous allez placer le fichier audio correspondant dans les ressources 
de l’application. Cliquez du bouton droit sur la première icône du volet de navigation 
et sélectionnez New Group dans le menu contextuel. Donnez le nom « Resources » à ce 
nouveau dossier, puis glissez-déposez le fichier Applaudissements, caf du Finder dans 
ce dossier. 



Lorsque vous déposez le fichier audio dans le dossier Resources, une 
boîte de dialogue est affichée. Veillez à cocher la case Copy items into 
destination group’s folder (if needed) pour que le fichier soit copié 
(et pas seulement référencé) dans les ressources. 
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Figure 18.1 - Ajoutez le framework AudioToolbox 

En consultant la documentation Apple sur le terme « System Sound Services Réfé- 
rencé », vous pouvez voir qu’il vous faudra utiliser les deux méthodes suivantes : 

1. AudioServicesCreateSystemSoundlD 

2. AudioServicesPlaySystemSound 

Ces méthodes proviennent du framework AudioToolbox/ AudioServices. h et sont dé- 
clarées dans le fichier d’en-têtes AudioServices. h. 

La prochaine étape va donc consister à faire référence au framework dans le fichier 
d’en-têtes de l’application. Cliquez sur ViewController .h dans le volet de navigation 
et ajoutez l’instruction #import suivante : 

l| #import < AudioToolbox/ AudioServices . h> 

Le fichier d’en-têtes doit maintenant ressembler à ceci : 

1 # import <UIKit/UIKit.h> 

2 #import <âudioToolbox/ AudioServices . h> 

3 

4 ©interface ViewController : UlViewController 

5 

6 ©end 

Cliquez sur ViewController .m dans le volet de navigation et complétez la méthode 
viewDidLoad comme suit : 

1 - (void) viewDidLoad 

2 { 
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3 [super viewDidLoad] ; 

4 SystemSoundlD bravo; 

5 AudioServicesCreateSystemSoundlD ( CFBundleC opyRes our ceURL ( 

CFBundleGetMainBundle () , CFSTR (" Applaudissements ") , CFSTR( 
"caf ") , NULL) , ftbravo) ; 

6 AudioServicesPlaySystemSound (bravo ) ; 

7 } 

Examinons les instructions contenues dans cette méthode. La ligne 4 définit l’objet 
bravo de type SystemSoundlD. C’est dans cet objet que sera stocké le son à jouer. 

La ligne 5 appelle la méthode AudioServicesCreateSystemSoundID. Ne soyez pas 
effrayés par l’apparente complexité de cette méthode. Cette écriture un peu lourde 
vient du chaînage (entendez par là, de l’exécution consécutive) de plusieurs méthodes 
dans une seule instruction. Procédons par étapes, et vous verrez que cette instruction 
est tout à fait compréhensible. 

La méthode AudioServicesCreateSystemSoundlD admet deux arguments : l’adresse 
URL du fichier audio à jouer et l’adresse d’un objet SystemSoundlD qui sera associée 
au son. Voici à quoi ressemble cette méthode : 

1 Audio Servi ce sCreate Sy s temSoundlD (URL - f ichier - audio , adresse- 
SystemSoundlD ) ; 

O Bien que les applications iOS soient composées de plusieurs fichiers, elles ap- 
paraissent sous la forme d'un fichier unique appelé « bundle ». Ce fichier ren- 
ferme toute l'arborescence de l'application. Ainsi par exemple, les ressources 
font partie du bundle de l'application. 

Pour obtenir l’adresse URL d’un élément situé dans les ressources de l’application, 
nous utilisons la méthode CFBundleCopyResourceURL. Cette méthode admet quatre 
arguments : le nom du bundle à examiner, le nom de la ressource, l’extension de la 
ressource et le dossier dans lequel elle est stockée. Voici à quoi ressemble cette méthode : 

1 CFBundleCopyRe s our ceURL (nom - bundle , nom - res s our ce , extension- 
ressource, dossier - ressource ) ; 


Mais d'où viennent toutes ces informations? 


De la documentation Apple tout simplement ! Dans la page « System Sound Services 
Reference », examinez la section AudioServicesCreateSystemSoundlD et vous trou- 
verez toutes les informations nécessaires. 

Le bundle de l’application est obtenu avec la méthode CFBundleGetMainBundle. Viennent 
ensuite le nom du fichier (CFSTR("Applaudissements") ), son extension (CFSTR("caf ") ) 
et enfin le dossier du fichier (NULL). 
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Pourquoi ne pas avoir utilisé les chaînes Applaudissements et caf dans le 
deuxième et le troisième argument? Et pourquoi le dernier argument est égal 
à NULL ? 


Une fois encore, je vous renvoie à la documentation Apple. Vous y apprendrez que le 
deuxième et le troisième argument doivent être des chaînes constantes et non de simples 
chaînes. De plus, pour transformer une chaîne en une chaîne constante, il faut utiliser 
la fonction CFSTR(). 

Quant au quatrième paramètre qui, rappelons-le, est censé définir le dossier dans lequel 
se trouve la ressource, la valeur NULL facilite l’écriture. En effet, elle indique que c’est 
au device de trouver dans quel dossier la ressource a été stockée. Tant que vous n’avez 
pas plusieurs centaines de ressources, cette technique est tout à fait possible. Alors, 
pourquoi s’en passer ? 

La méthode CFBundleCopyResourceURL a donc retourné l’adresse URL de la ressource. 
Je vous rappelle que la méthode AudioServicesCreateSystemSoundlD demande deux 
paramètres : l’adresse URL du fichier à jouer et l’adresse d’un objet SystemSoundID. 
Cette dernière est obtenue avec &bravo. 

Nous arrivons donc à l’instruction suivante : 

1 AudioServicesCreateSystemSoundlD (CFBundleCopyResourceURL ( 

CFBundleGetMainBundle ( ) , CFSTR (" Applaudi s sement s ") , CFSTR(" 
caf") , NULL) , ftbravo) ; 


Je vous rassure tout de suite : le plus gros du travail a été fait. Maintenant, il suf- 
fit d’appeler la méthode AudioServicesPlaySystemSound en lui transmettant l’objet 
SystemSoundID pour déclencher la lecture du son : 

1 | AudioServicesPlaySystemSound (bravo ) ; 

Vous pouvez (enfin !) lancer l’application. Des applaudissements vous acclament ! Vous 
avez réussi à jouer votre premier son dans le simulateur. Bien entendu, cette application 
fonctionne sans problème sur votre device. 

Le code source se trouve dans le dossier ecouteAudio. 


Copier ce code 

\ 

^Code web : 437234 

J 


ViewController .h 

1 # import <UIKit/UIKit.h> 

2 #import < AudioToolbox/ AudioServices . h> 

3 

4 ^interface ViewController : UlViewController 

5 

6 ®end 

ViewController .m 
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#import " V iewC ont r oller . h" 

@ implement at i on ViewController 

- ( vo id ) di dRe cei veMemory Warning 

{ 

[super didReceiveMemoryWarning] ; 

// Release any cached data, images, etc that aren ' t in use. 

} 

#pragma mark - View lifecycle 

- ( vo id ) viewDidLoad 

{ 

[super viewDidLoad]; 

SystemSoundlD bravo; 

AudioServicesCreateSystemSoundlD ( CFBundleC opyRes our ceURL ( 

CFBundleGetMainBundle () , CFSTR (" Applaudissements ") , CFSTR( 
"caf ") , NULL) , ftbravo) ; 

AudioServicesPlaySystemSound (bravo ) ; 

} 

- ( vo id ) viewDidUnload 

{ 

[super viewDidUnload]; 

// Release any retained subviews of the main view . 

// e.g. self . myOutlet = nil; 

} 

- (void)viewWillAppear:(B00L) an i mat ed 

{ 

[super viewWillAppear : animated] ; 

} 

- (void) viewDidAppear : (B00L) animated 

{ 

[super viewDidAppear : animated] ; 

} 

- (void)viewWillDisappear:(BOOL) animated 

{ 

[super viewWillDisappear : animated] ; 

} 

- (void) viewDidDisappear : (B00L) animated 

{ 

[super viewDidDisappear : animated] ; 

} 
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- (B00L) shouldAutorotateTo Interface Orientât ion : ( 

UlInterfaceOrientation) interf aceûrientation 

{ 

// Return YES for supported orientations 
return ( int erf ace Or ient at ion ! = 

UIInterfaceOrientationPortraitUpsideDown) ; 

} 

®end 


La technique AV AudioPlayer 

Les iPhone, iPod Touch et iPad disposent de l’application iPod, qui permet d’écouter de 
la musique et de visualiser des vidéos. Les techniques de programmation utilisées dans 
cette application sont accessibles aux développeurs Objective-C grâce (entre autres) 
à la classe AVAudioPlayer. Cette approche a plusieurs avantages par rapport à la 
précédente. 

Elle permet : 

- de jouer des sons courts ou longs ; 

- de jouer des sons compressés, au format MP3 par exemple ; 

- d’utiliser plusieurs méthodes pour contrôler le son pendant qu’il est joué. 

Elle repose sur : 

- l’utilisation des frameworks AVFoundation et AudioToolbox ; 

- la mise en place du delegate AVAudioPlayerDelegate ; 

- la définition d’un objet AVAudioPlayer ; 

- la mise en place de ressources dans l’application pour stocker le fichier audio à jouer ; 

- l’utilisation de méthodes sur l’objet AVAudioPlayer pour contrôler le son pendant 
qu’il est joué. 

Commençons sans plus attendre. Définissez un nouveau projet basé sur le modèle 
Single View Application et donnez-lui le nom « audioPlayer ». 


Insertion des frameworks dans le projet 

Ajoutez les frameworks AVFoundation. framework et AudioToolbox. framework dans 
le projet. Comme indiqué à la figure 18.2, cliquez sur la première icône affichée dans 
le volet de navigation (1), basculez sur l’onglet Build Phases dans le volet droit de 
Xcode (2), développez l’entrée Link Binary With Libraries (3), cliquez sur l’icône 
+ (4) et ajoutez les deux frameworks dont nous avons parlé. 


Définition de l’objet AVAudioPlayer et mise en place du delegate associé 

Cliquez sur ViewController .h dans le volet de navigation et insérez-y deux instruc- 
tions #import pour faire référence aux frameworks que vous avez ajoutés dans l’étape 
précédente : 
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Figure 18.2 - Ajoutez les deux frameworks 


1 #import <AVFoundation/ AVFoundation . h> 

2 #import < AudioToolbox / Audi oToolbox . h> 


Définissez la variable d’instance audioPlayer de classe AVAudioPlayer : 
il AVAudioPlayer * audioPlayer; 


Cet objet va vous permettre de jouer des fichiers audio quelconques, à condition qu’ils 
soient compatibles avec les formats audio supportés par iOS : AAC, ALAC, HE-AAC, 
iLBC, IMA4, Linear PCM, MP3, ^t-law ou a-law. 

Pour vous tenir informés des événements relatifs à la lecture du fichier audio (position 
dans le son, fin du son atteint, etc.), mais également des événements externes (récep- 
tion d’un appel téléphonique par exemple), l’application doit implémenter le protocole 
AVAudioPlayerDelegate. Pour ce faire, il vous suffit d’ajouter ce protocole dans la 
définition de l’interface : 


©interface ViewCont r oller 
AVAudioPlayerDelegate > 

{ 

} 


UlViewController < 


Si vous avez suivi mes consignes, le fichier ViewController .h doit maintenant ressem- 
bler à ceci : 

il # import <UIKit/UIKit.h> 
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6 

7 

8 
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# import < A VF oundat ion/ A VF oundat ion . h> 

# import <AudioToolbox/ AudioToolbox .h> 

Ointerface ViewController : UlViewController < 
AV Audi oPlayerDelegat e > 

{ 

AV AudioPlayer * audioPlayer; 

} 

8end 


Ajout du fichier audio dans les ressources 

Le fichier d’en-têtes étant entièrement écrit, nous allons passer à l’étape suivante en 
ajoutant un fichier audio dans les ressources de l’application. 

Cliquez du bouton droit sur la première icône affichée dans le volet de navigation 
et sélectionnez New Group dans le menu contextuel. Donnez le nom « Resources » au 
nouveau dossier. Ouvrez le Finder et glissez-déposez un fichier audio quelconque du 
Finder dans le dossier Resources. Au relâchement du bouton gauche de la souris, une 
boîte de dialogue est affichée. Assurez-vous que la case Copy items into destination 
group’s folder soit cochée, puis cliquez sur Finish. 


Le code de l’application 


Il ne reste plus qu’à écrire le code de l’application. 

Cliquez sur ViewController. m dans le volet de navigation. Cette première approche de 
la classe AV AudioPlayer se voulant avant tout pratique, nous allons nous contenter de 
jouer un son, sans chercher à le contrôler. Complétez la méthode viewDidLoad comme 
suit : 


1 

2 

3 

4 

5 

6 

7 

8 

9 

10 

11 


12 

13 


- (void) viewDidLoad 

{ 

[super viewDidLoad]; 

Audi oSes s ionlni t iali ze (NULL, NULL, NULL, (__bridge void *) 
self ) ; 

UInt32 sessionCategory = kAudi oSes s ionCat egory _MediaP layback ; 

AudioSes s ionSe tPr opert y ( kAudio Ses s ionPr oper t y _ Audi oCat egory , 
sizeof (sessionCategory), & se s s i onCat egory ) ; 

NSData * soundFileData ; 

s oundFileDat a = [NSData dat aWit hCont ent s Of URL : [NSURL 

f ileURLWithPath : [ [NSBundle mainBundle] pathForRe s our ce : @ " 
morceau. mp3" of Type : NULL ]]] ; 

audioPlayer = [ [ AVAudioPlayer alloc] initWithData : 

soundFileData error:NULL]; 
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14 

15 

16 

17 

18 

19 

20 
21 
22 
23 


if ( ! ( [audioPlayer prepareToPlay])) 

NSLog(@"La méthode prepareToPlay a renvoyé la valeur FALSE" 

) ; 

audioPlayer . delegate = self; 

[audioPlayer setVolume : 1 . Of ] ; 

[audioPlayer play]; 


[Copier ce 

code 


[Code web 

: 585720 

J 


La ligne 5 initialise le contexte audio : 

I AudioSes s ionlnit ial ize (NULL, NULL, NULL, (__bridge void *)self 

) ; 

II n’est pas nécessaire de comprendre toutes les subtilités de cette instruction pour 
pouvoir l’utiliser. Sachez juste qu’elle doit toujours être appelée avant d’utiliser un 
objet AV AudioPlayer. 

La ligne 7 définit l’entier sessionCategory et l’initialise avec la valeur : 

1 | kAudi oSes s ionCat egory _MediaP layback ; 

Si vous vous reportez à la documentation Apple, vous verrez que cette constante de- 
mande au device de jouer le son dans tous les cas, y compris si le bouton muet est actif, 
ou encore si le device passe en mode veille. 

La ligne 8 initialise la propriété kAudioSessionProperty_AudioCategory de la session 
audio en lui transmettant la valeur définie dans l’instruction précédente. Le fichier audio 
sera donc joué dans tous les cas, y compris quand le bouton muet est actif, ou encore 
si le device passe en mode veille : 

1 Audio Ses s ionSe tPr opert y ( kAudi oSes s ionPr opert y _ AudioCat egor y , 
sizeof (sessionCategory), & se s s ionCat egory ) ; 

La ligne 9 définit l’objet soundFileData de classe NSData : 

l| NSData ♦soundFileData; 

Cet objet est utilisé pour faire référence au fichier audio à jouer : 

1 soundFileData = [NSData dat aWi thC ont ent s Of URL : [NSURL 

f ileURLWithPath : [ [NSBundle mainBundle] pathForRes our ce : @ " 
morceau. mp3 " of Type : NULL ]]] ; 

Ne vous laissez pas surprendre par l’apparente complexité de cette instruction : elle 
se contente de chaîner trois messages. Si nous la décomposons en trois parties bien 
distinctes, tout sera bien plus clair. 
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L’objet soundFileData est initialisé (soundFileData =) avec un objet NSData ( [NSData 
. . . ) qui contient les données stockées à l’adresse spécifiée (dataWithContentsOfURL : ). 
Cette URL se trouve dans le « bundle principal », c’est-à-dire dans l’application elle- 
même ([NSBundle mainBundle] ) . 

Le nom du fichier est « morceau. mp3 » (pathForResource : @"morceau.mp3"). L’exten- 
sion du fichier n’est pas précisée (of Type : NULL] ) puisque le nom du fichier la contient 
déjà. 

Alors, cette instruction? Tout à fait compréhensible, n’est-ce pas? 

La ligne 13 réserve de la mémoire pour l’objet audioPlayer ( [AV AudioPlayer alloc] ) 
et l’initialise avec les données qui ont été placées dans l’objet soundFileData dans 
l’instruction précédente (initWithData: soundFileData) : 

1 audioPlayer = [ [ AVAudioPlayer alloc] initWithData : soundFileData 

err or : NULL ] ; 

Le son est prêt à être joué. La méthode prepareToPlay le précharge en mémoire. Si 
le préchargement ne s’est pas bien déroulé, la valeur FALSE est retournée. Dans ce cas, 
un message d’erreur est affiché dans la console : 

1 if (!( [audioPlayer prepareToPlay])) 

2 NSLog(@"La méthode prepareToPlay a renvoyé la valeur FALSE"); 

L’instruction de la ligne 18 indique que les messages relatifs à l’objet audioPlayer 
seront traités dans ViewController .m : 

1 | audioPlayer . delegate = self ; 

Cette instruction aurait tout aussi bien pu ne pas apparaître puisque dans cet 
exemple très simple, aucun des messages relatifs à l'objet audioPlayer n'est 
traité. 

La ligne 20 définit le volume sonore : 
l| [audioPlayer setVolume : 1 . Of ] ; 

La valeur passée à la méthode setVolume doit être comprise entre O.Of (aucun 
son) et l.Of (volume maximum). 

Et enfin, la ligne 22 lance la lecture du fichier audio : 

1 | [audioPlayer play] ; 

Vous pouvez lancer l’application en cliquant sur l’icône Run. Je vous laisse savourer! 

Le code de cette application se trouve dans le dossier audioPlayer. 


Copier ce code 

\ 

^Code web : 682654 

J 
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ViewController .h 


1 

2 

3 

4 

5 

6 

7 

8 
9 


# import CUIKit/UIKit .h> 

# import < A VFoundat i on/ AVFoundat ion . h> 

# import <AudioToolbox/AudioToolbox .h> 

©interface ViewController : UlViewController < 
AVAudioPlayerDelegate > 

{ 

AVAudioPlayer * audioPlayer; 

} 

®end 


ViewController .m 


1 

2 

3 

4 

5 

6 

7 

8 
9 

10 

11 

12 

13 

14 

15 

16 

17 

18 

19 

20 
21 
22 


23 

24 

25 

26 

27 

28 
29 


#import "ViewController . h" 

©implémentation ViewController 

- ( vo id ) didRe cei veMemory Warning 

{ 

[super didReceiveMemoryWarning] ; 

// Release any cached data, images, etc that aren ' t in use. 

} 

#pragma mark - View lifecycle 

- ( void ) viewDidLoad 

{ 

[super viewDidLoad]; 

Audio Ses s ionlnit ial ize (NULL, NULL, NULL, (__bridge void *) 
self ) ; 

UInt32 sess ionCategory = k Audio Ses s i onCat egory _MediaP layback ; 
Audio Ses s ionSetPr opert y (kAudioSessionProperty_AudioCategory , 
sizeof ( s es s ionCategory ) , & ses s ionCategory ) ; 

NSData * soundFileData ; 

soundFileData = [NSData dat aWi thC ont ent s Of URL : [NSURL 

f ileURLWithPath : [ [NSBundle mainBundle] pathForResource : © " 
morceau. mp3" of Type : NULL ]]] ; 

audioPlayer = [[AVAudioPlayer alloc] initWithData : 
soundFileData error:NULL]; 

if ( ! ( [ audi oPlayer prepareToPlay])) 

NSLog(©"La méthode prepareToPlay a renvoyé la valeur FALSE" 

) ; 


audioPlayer . delegate 


self ; 
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65 

66 
67 


[audioPlayer setVolume : 1 . Of ] ; 

[audioPlayer play]; 

} 

- (void) viewDidUnload 

{ 

[super viewDidUnload]; 

// Release any retained subviews of the main view. 
// e.g. self . myOut let = nil ; 

} 

- (void) viewWill Appear : (B00L) animated 

{ 

[super viewWillAppear : animated] ; 

} 

- (void) viewDidAppear : (B00L) animated 

{ 

[super viewDidAppear : animated] ; 

} 

- (void) viewWillDis appear : (B00L) animated 

{ 

[super viewWillDisappear : animated] ; 

} 

- (void) viewDidDisappear : (B00L) animated 

{ 

[super viewDidDisappear : animated] ; 

} 

- (B00L) shouldAutorotateTo Interface Orientât ion : ( 

UlInterfaceOrientation) interf aceûrientation 

{ 

// Return YES for supported orientations 
return ( int erf ace Or ient at ion ! = 

UIInterfaceOrientationPortraitUpsideDown) ; 

} 


Oend 


Un peu plus loin avec la technique AVAudioPlayer 

Je ne sais pas pour vous, mais moi, je trouve l’application précédente un peu « tris- 
tounette ». Certes, elle joue le fichier MP3 à la perfection, mais l’écran du device 
reste désespérément vide. Que diriez-vous d’ajouter un arrière-plan à l’application, un 
contrôle de progression pour savoir où en est la lecture du fichier et un contrôle de 
volume pour ajuster le volume sonore comme vous l’entendez? Tentant non? Eh bien, 
allons-y. 
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Commencez par dupliquer le dossier de l’application audioPlayer : cliquez sur le dos- 
sier audioPlayer, appuyez sur [ Command ) + [~C~] , puis sur ( Command ) + [vJ et renommez- 
la copie audioPlayer-v2. 


Ajout de nouveaux contrôles dans la vue 

Cliquez sur MainStoryboard. storyboard dans le volet de navigation, puis insérez 
trois contrôles Label, un contrôle Slider et un contrôle Progress View dans la vue. 
Modifiez les dimensions par défaut de ces contrôles, la couleur d’arrière-plan et la 
couleur du texte des Label et disposez les contrôles dans la vue pour obtenir quelque 
chose ressemblant à la figure 18.3. 


» 


Label 


Volume 


Position 


Figure 18.3 - Disposez vos contrôles comme ceci 



Je vous rappelle que vous pouvez modifier les caractéristiques d'un contrôle 
en utilisant le volet des utilitaires : si nécessaire, cliquez sur l'icône Hide or 
show the Utilities pour faire apparaître le volet des utilitaires, cliquez sur 
le contrôle dont vous voulez modifier les caractéristiques, puis sur l'icône Show 
the Attributes Inspector pour accéder aux caractéristiques du contrôle. 


Définissez : 

- l’outlet dureeTotale pour le premier contrôle Label (celui dans lequel est écrit 
« Label » ) ; 
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- l’outlet laPosition pour le contrôle Progress View; 

- l’action leVolume pour le contrôle Slider. 



Pour ceux qui auraient la mémoire courte, il suffit de contrôle-glisser-déposer 
un contrôle depuis la zone d'édition dans le fichier d’en-têtes, juste avant 
l'instruction @end pour créer un outlet ou une action. Choisissez Outlet ou 
Action dans la zone de texte Connection selon l'effet recherché, choisissez 
un nom dans la zone Name et cliquez sur Connect. 


Pour en terminer avec le fichier d’en-tétes, définissez la variable d’instance playbackTimer 
de type NSTimer. Cette variable sera utilisée pour mettre à jour la position de lecture 
dans le contrôle Progress View : 

il NSTimer* playbackTimer; 


Si vous avez suivi mes indications, le fichier d’en-têtes devrait ressembler à ceci : 


1 

2 

3 

4 

5 

6 

7 

8 
9 

10 

11 

12 


# import CUIKit/UIKit .h> 

# import < A VF oundat ion/ A VF oundat ion . h> 

#import < AudioToolbox/ AudioToolbox .h> 

^interface ViewController : UlViewController < 
AVAudioPlayerDelegate > 

{ 

AVAudioPlayer * audioPlayer; 

NSTimer* playbackTimer; 

} 

Sproperty (weak , nonatomic) IBOutlet UILabel * dureeTotale ; 
Oproperty (weak, nonatomic) IBOutlet UlProgressView *laPosition 


13 - ( IBAction) leVolume :( id) sender ; 

14 

15 8end 


Vous allez maintenant ajouter quelques lignes de code pour donner vie à ces contrôles. 


Mise en place d’un timer 

Cliquez sur ViewController .m dans le volet de navigation. Vous allez insérer du code 
juste au-dessus de l’instruction [audioPlayer play] . 

Votre première action va consister à mettre en place un « timer », c’est-à-dire un 
mécanisme qui déclenchera l’exécution d’une méthode à intervalles réguliers. Cette 
méthode sera utilisée pour mettre à jour le contrôle Progress View pendant la lecture 
du fichier audio : 

1 playbackTimer = [NSTimer s cheduledT imerWit hTime Int er val : 0 . 5 

2 target : self 

3 selector : Sselector (miseAJour : ) 
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4 us er Inf o : nil 

5 repeat s : YES ] ; 

Cette instruction initialise l’objet NSTimer playbackTimer en utilisant la méthode 

scheduledTimerWithTimelnterval. Cette dernière demande cinq paramètres. 

- La durée entre deux exécutions de la méthode, en secondes. Ici 0,5 seconde, soit deux 
fois par seconde. 

- L’objet dans lequel se trouve la méthode à exécuter périodiquement. Ici, la valeur 
self indique que l’objet se trouve dans l’application. 

- Le nom de la méthode à exécuter. Ici, miseAJour. 

- Les informations à passer à la méthode. Ici, la valeur nil indique qu’aucune infor- 
mation n’est passée à la méthode miseAJour. 

- La répétition ou la non-répétition de l’exécution de la méthode. Ici, la valeur YES 
provoque la répétition de la méthode miseAJour jusqu’à ce que le timer soit désactivé. 


Affichage de la durée totale du fichier audio 

Vous allez ajouter deux lignes de code dans la méthode viewDidLoad, juste avant le 
message [super viewDidLoad] ; . Pour afficher la durée totale du fichier audio dans 
le Label, commencez par définir la variable longueur de type float, et stockez-y la 
durée totale du fichier audio : 

l| float longueur=audioPlayer . duration ; 

Il ne reste plus qu’à afficher cette valeur dans le contrôle Label dureeTotale : 

1 dureeTotale . text = [NSString stringWithFormat: ©"Durée totale : 
’/,i secondes" , (int) longueur] ; 

Cette instruction peut paraître un peu complexe pour quelque chose d’aussi simple 
qu’afficher une valeur dans un Label. Sa longueur s’explique par le fait qu’elle ne 
se contente pas de stocker une variable dans une autre. Rappelez-vous : la durée du 
fichier audio a été stockée dans un nombre à virgule (float). Dans un premier temps, 
ce nombre est converti en un entier pour supprimer la virgule ((int) longueur), puis 
en un NSString ([NSString stringWithFormat:) pour assurer la compatibilité avec 
la propriété text du Label. 

La méthode viewDidLoad doit maintenant ressembler à ceci : 

1 - ( vo id ) viewDidLoad 

2 { 

3 Audio Ses s ionlnit ial ize (NULL, NULL, NULL, (__bridge void *) 

self ) ; 

4 

5 UInt32 sess ionCategory = k Audio Ses s i onCat egory _MediaP layback ; 

6 Audio Ses s ionSetPr opert y (kAudioSessionProperty_AudioCategory , 

sizeof ( s es s ionCategory ) , & ses s ionCategory ) ; 

7 

8 NSData * soundFileData ; 


337 


CHAPITRE 18. MULTIMÉDIA : LE SON 


9 


10 

11 


soundFileData = [NSData dat aWit hCont ent s Of URL : [NSURL 

f ileURLWithPath : [ [NSBundle mainBundle] pathForRe s our ce : @ " 
morceau. mp3" of Type : NULL ] ] ] ; 

audioPlayer = [ [ AVAudioPlayer alloc] initWithData : 

soundFileData error:NULL]; 


13 

14 

15 

16 

17 

18 

19 

20 
21 
22 

23 

24 

25 

26 

27 

28 

29 

30 

31 


if ( ! ( [audioPlayer prepareToPlay ] ) ) 

NSLog(@"La méthode prepareToPlay a renvoyé la valeur FALSE" 

) ; 

audioPlayer . delegate = self ; 

[audioPlayer setVolume : 1 . Of ] ; 

playbackTimer = [NSTimer scheduledTimerWithTimelnterval : 0 . 5 
target : self 

selector : Oselector (miseAJour : ) 
user Inf o : nil 
repeat s : YES ] ; 

[audioPlayer play]; 

f loat 1 o ngueur= audioPlayer .duration; 

dureeTotale . text = [NSString stringWithFormat : ©"Durée totale 
: ’/,i secondes " , (int ) longueur] ; 

[super viewDidLoad] ; 


| Copier ce code 
> 1 Code web : 471501 


Animation du Progress View 

Vous devez certainement être pressés d’exécuter l’application pour voir le contrôle 
Progress View se mettre à jour pendant que le morceau est joué. Mais réfléchissez un 
peu. Ne croyez- vous pas qu’il manque quelque chose pour cela ? 

Mais c’est bien sûr : la méthode miseAJour ! Voici le code à ajouter : 

1 -(void) miseAJour : (NSTimer*) timer 

2 { 

3 float t otal = audioPlayer . durât ion ; 

4 float f =audioPlayer . currentTime / total; 

5 laPos it i on . pr ogre s s =f ; 

6 } 

La propriété progress d’un contrôle Progress View définit la position de la barre de 
progression. De type float, elle est comprise entre 0.0 (complètement à gauche) et 
1.0 (complètement à droite). Pour déplacer la barre en fonction de la position dans le 
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morceau, il suffit de diviser la position actuelle par la durée du morceau et de l’affecter 
à la propriété progress. C’est précisément ce que fait cette méthode. 

Dans un premier temps, la durée totale du morceau est stockée dans la variable f loat 
total : 

l| float total = audioPlayer . duration ; 

Dans un deuxième temps, la position actuelle (audioPlayer. currentTime) est divisée 
par la durée du morceau (total) et affectée à la variable float f : 

l| float f = audi oPlay er . current Time / total; 

Enfin, dans un troisième temps, la variable f est affectée à la propriété progress du 
contrôle Progress View, ce qui provoque sa mise à jour : 

l| laPos it ion . progrès s =f ; 

Cliquez sur l’icône Run et observez le déplacement de la barre de progression. Impres- 
sionnant, non? 


Détection de la fin du son et arrêt du timer 

Cette courte récréation terminée, retournons au code. 

Quelques lignes plus tôt, nous parlions de la création d’un timer avec la méthode 
scheduledTimerWitliTimelnterval. Comme il a été vu, la méthode miseAJour est 
exécutée indéfiniment deux fois par seconde. Vous serez d’accord avec moi : cette mé- 
thode n’a plus aucune utilité lorsque le morceau a été entièrement joué. C’est pourquoi 
nous allons y mettre fin à ce moment-là. 

Une courte recherche dans la documentation Apple montre que la méthode exécutée 
lorsque le morceau est entièrement joué, a pour nom audioPlayerDidFinishPlaying. 

Une courte recherche dans la documentation Apple? J'ai recherché et je n'ai 
rien trouvé ! Puis-je avoir quelques explications? 

Si un événement est généré lorsque le morceau a été entièrement joué, c’est dans le 
protocole AVAudioPlayerDelegate qu’il faut le rechercher. Vous êtes d’accord avec 
moi ? Ce delegate est en effet en charge de tous les événements en rapport avec l’ob- 
jet AV AudioPlayer audioPlayer utilisé dans cette application. Pour trouver la mé- 
thode exécutée lorsque le morceau a été entièrement joué, j’ai donc tout naturellement 
consulté l’aide sur le protocole AVAudioPlayerDelegate. Pour cela, j’ai affiché le fichier 
d’en-têtes (1), cliqué sur AVAudioPlayerDelegate (2), puis sur AVAudioPlayerDelegate 
Protocol Reference (3), comme à la figure 18.4. 

Le clic sur AVAudioPlayerDelegate Protocol Reference provoque l’affichage de la 
fenêtre d’aide. Quelques secondes suffisent pour comprendre que la méthode recherchée 
est audioPlayerDidFinishPlaying. 

Après cet intermède, définissez la méthode suivante : 



339 


CHAPITRE 18. MULTIMÉDIA : LE SON 


« o o 



a iPhone 


audioPlayer.xcodeproj h ViewConlroller.h 
flmshed running audioPlayer on iPhone 5.0 Sunulati 


|LJ El QqID [SJ 



Figure 18.4 - Trouver la méthode audioPlayerDidFinishPlaying 


1 -( void ) audi oPlayerD idFinishPlaying :( AV AudioPlayer *)player 

successfully : (B00L) flag 

2 { 

3 [playbackTimer invalidate]; 

4 } 



La première ligne, d'apparence assez complexe, ne fait que reprendre le ga- 
barit de la fonction. Ne vous en faites pas quant à sa syntaxe : la fonction 
autocomplete de Xcode l'écrit pratiquement toute seule au fur et à mesure 
que vous tapez quelques caractères au clavier. 


Lorsque le fichier audio a été entièrement joué, la méthode invalidate est appliquée 
à l’objet playbackTime, ce qui provoque la suppression du timer : 

1 I [playbackTimer invalidate] ; 


Réglage du niveau sonore avec le Slider 

Vous allez maintenant donner vie au contrôle Slider pour que l’utilisateur puisse régler 
le niveau sonore. 

Rappelez-vous : une action de type Value Changed a été définie pour le contrôle 
Slider. Chaque fois que la position du curseur sera modifiée par l’utilisateur, la mé- 
thode action correspondante (c’est-à-dire la méthode leVolume) sera exécutée. Ajoutez 
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les instructions suivantes dans cette méthode : 

1 - ( IBAction) leVolume : ( id) sender 

2 { 

3 UISlider *slider = (UISlider*) sender; 

4 [audioPlayer setVolume : slider . value] ; 

5 } 

La ligne 3 définit l’objet slider de classe UISlider à partir du contrôle Slider (sender) : 
l| UISlider ♦slider = (UISlider*) sender; 

La ligne 4 applique la méthode setVolume à l’objet audioPlayer en lui transmettant 
la position du curseur (slider .value) dans le contrôle Slider : 

l| [audioPlayer setVolume : slider . value] ; 

C’est aussi simple que cela. Vous pouvez tester, cela fonctionne parfaitement ! 


Ajout d’un arrière-plan 

Pour terminer en beauté, vous allez ajouter un fond d’écran à l’application. Procurez- 
vous une image au format JPG ou PNG de 320 x 480 pixels. Au besoin, redimensionnez 
une image existante. Une fois en possession de l’image, faites-la glisser depuis le Finder 
vers le dossier Resources de l’application et confirmez son insertion dans les ressources 
en cochant la case Copy items into destination group’s folder (if needed). 

Pour utiliser cette image en arrière-plan de la vue, cliquez sur ViewController .m dans 
le volet de navigation et ajoutez la ligne suivante au début de la méthode viewDidLoad : 

1 self . view . backgroundColor = [[UlColor alloc] 

initWithPatternlmage : [UI Image imageNamed :0"arb.jpg"]]; 



Dans mon application, l'image s'appelle « arbjpg » ; ce sera certainement 
différent chez vous, n'oubliez pas de mettre à jour votre code en conséquence. 


Comme vous pouvez le voir, la propriété backgroundColor de l’arrière-plan de la vue 
(self .view) est utilisée pour afficher l’arrière-plan. Cette propriété est initialisée avec 
une image (initWithPatternlmage) nommée « arb.jpg » (imageNamed :@"arb. jpg"). 

Vous pouvez cliquer sur Run et profiter de votre application. La figure 18.5 représente 
mon rendu final. 


L’application se trouve dans le dossier audioPlayer-v2. 


> 


Copier de code 
^Code web : 182773 


ViewController .h 
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Figure 18.5 - Mon rendu final 
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# import CUIKit/UIKit .h> 

# import < A VF oundat ion/ A VF oundat ion . h> 

# import <AudioToolbox/ AudioToolbox .h> 

©interface ViewController : UlViewController < 

AV AudioPlayerDelegate > 

{ 

AV AudioPlayer * audioPlayer; 

NSTimer* playbackTimer ; 

} 

©property (weak, nonatomic) IBOutlet UILabel * dureeTotale ; 
©property (weak, nonatomic) IBOutlet UlPr ogres s View * laPos it ion 


13 - ( IBAction) leVolume : ( id) sender ; 

14 

15 ©end 


ViewController .m 
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#import "ViewController .h" 

©implémentation ViewController 
©synthesize dureeTotale; 
©synthesize laPosition; 
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- ( vo id ) didRe cei veMemory Warning 

{ 

[super didReceiveMemoryWarning] ; 

// Release any cached data, images, etc that aren't in use. 

} 

#pragma mark - View lifecycle 

- ( vo id ) viewDidLoad 

{ 

self . view . backgroundColor = [[UlColor alloc] 

initWithPatternlmage : [UI Image imageNamed :®"arb.jpg"]]; 

Audio Ses s ionlnit ial ize (NULL, NULL, NULL, (__bridge void *) 
self ) ; 

UInt32 s es s ionCat egory = k Audio Ses s i onCat egory _MediaP layback ; 
Audio Ses s ionSetPr opert y (kAudioSessionProperty_AudioCategory , 
sizeof ( s es s ionCat egory ) , & ses s ionCat egory ) ; 

NSData * soundFileData ; 

soundFileData = [NSData dat aWi thC ont ent s Of URL : [NSURL 

f ileURLWithPath : [ [NSBundle mainBundle] pathForResource : @ " 
morceau. mp3 " of Type : NULL ]]] ; 

audioPlayer = [ [ AV Audi oPlayer alloc] initWithData : 

soundFileData error:NULL]; 

if ( ! ( [ audioPlayer prepareToPlay] ) ) 

NSLog(@"La méthode prepareToPlay a renvoyé la valeur FALSE" 

) ; 

audioPlayer . delegate = self; 

[audioPlayer setVolume : 1 . 0] ; 

playbackTimer = [NSTimer s cheduledTimerWi thTimelnt erval : 0 . 5 
target : self 

selector : Oselector (miseAJour : ) 
userlnf o : nil 
repeat s : YES ] ; 

[audioPlayer play]; 

f loat longueur = audioPlayer . duration ; 

dureeTotale . text = [NSString stringWithFormat : ©"Durée totale 
: '/,i secondes" , (int ) longueur] ; 

[super viewDidLoad]; 

} 
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-(void) miseAJour : (NSTimer*) timer 

{ 

float total = audioPlayer . duration ; 
float f = audioPlayer . current Time / total; 
laPosition . progress=f ; 

} 

- ( void ) audi oPlay erD idFinishPlay ing : (AVAudioPlayer * ) player 
successfully : (B00L) f lag 

{ 

[playbackTimer invalidate]; 

} 

- ( IBAction) leVolume : ( id) sender 

{ 

UISlider *slider = ( UI S lider * ) sender; 

[audioPlayer setVolume : slider . value] ; 

} 

- (void) viewDidUnload 

{ 

[self setDureeTotale : nil] ; 

[self setLaPosition : nil] ; 

[super viewDidUnload]; 

// Release any retained subviews of the main view . 

// e.g. self . myOut let = nil; 

} 

- (void) viewWill Appear : (B00L) animated 

{ 

[super viewWillAppear : animated] ; 

} 

- (void) viewDidAppear : (B00L) animated 

{ 

[super viewDidAppear : animated] ; 

} 

- (void) viewWillDis appear : (B00L) animated 

{ 

[super viewWillDisappear : animated] ; 

} 

- (void) viewDidDisappear : (B00L) animated 

{ 

[super viewDidDisappear : animated] ; 

} 


(B00L) shouldAutorotateTo Interface Orientât ion : ( 
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UI Interface Orientât ion) interface Orientât ion 

{ 

// Return YES for supported orientations 
return ( inter f aceOrientat ion != 

UIInterfaceOrientationPortraitUpsideDown) ; 

} 

®end 


Enregistrement audio 

Les iPhone, iPod Touch et iPad disposent d’un microphone. Voyons comment l’utiliser 
pour créer un dictaphone élémentaire. 

Cette application reposera sur l’utilisation du framework AVFoundation, et en particu- 
lier de deux de ses classes : AVAudioRecorder (pour l’enregistrement) et AV AudioPlayer 
(pour la lecture). Les événements relatifs aux objets de ces deux classes seront manipu- 
lés dans le code de la vue, par l’intermédiaire des delegate AVAudioRecorderDelegate 
et AVAudioPlayerDelegate. 


Création du projet 

Définissez un nouveau projet basé sur le modèle Single View Application et donnez- 
lui le nom « audioRecorder ». Ajoutez le framework AVFoundation au projet. Vous 
devriez maintenant savoir le faire, je ne détaillerai donc pas la manipulation. 

Définition de l’interface et du fichier d’en-têtes 

Cliquez sur MainStoryboard. storyboard dans le volet de navigation et ajoutez trois 
Round Rect Button au projet en faisant apparaître le texte « REC » 1 , « STOP » et 
« JOUE » sur ces trois boutons. 

Contrôle-glissez-déposez tour à tour ces trois contrôles dans le fichier d’en-têtes, juste 
au-dessus du @end final et définissez (respectivement) les actions enregistre, arrête 
et joue pour l’événement Touch Up Inside. 

L’interface est maintenant terminée. Jusqu’ici, tout va bien ! 

Cliquez sur ViewController .h dans le volet de navigation. Comme il a été précisé au 
début de cette section, cette application va s’appuyer sur les classes AVAudioRecorder 
et AVAudioPlayer. Les événements générés par ces deux classes seront gérés dans le 
code de la vue (ViewController .m). 

Ajoutez une instruction #import pour faire référence au framework AVFoundation et 
une référence aux delegate dans la déclaration de l’interface : 

l| #import <AVFoundation/ AVFoundation . h> 

1. « REC » vient de record , qui veut dire « enregistrer » en français. 
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©interface audi oRec o r derV iewCont r o 1 1er : UI ViewCont r o 1 le r < 
AVAudi oRecorderDelegate , AVAudioPlayerDelegate > 

{ 

} 


Pour terminer, définissez les objets audioRecorder de classe AVAudioRecorder et 
audioPlayer de classe AV AudioPlayer : 

1 AVAudioRecorder ♦ audioRecorder ; 

2 AVAudioPlayer ♦audioPlayer; 


Le code du fichier d’en-têtes devrait maintenant ressembler à ceci : 


î 
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# import CUIKit/UIKit .h> 

# import < A VF oundat ion/ A VF oundat ion . h> 

^interface ViewController : UlViewController < 

AV Audi oRecorderDelegate , AVAudioPlayerDelegate > 

{ 

AVAudioRecorder ♦audioRecorder; 

AVAudioPlayer ♦audioPlayer; 


- (IBAction) enregistre : (id) sender ; 

- ( IBAction) arrête :( id) sender ; 

- ( IBAction) j oue :( id) sender ; 

®end 


Initialisation de l’objet audioRecorder 

Avant de pouvoir lancer l’enregistrement, il faut initialiser l’objet audioRecorder. 
Cette opération se fera dès le lancement de l’application, dans la méthode viewDidLoad. 
Complétez cette méthode comme suit : 

1 - (void) viewDidLoad 

2 { 

3 [super viewDidLoad]; 

4 

5 NSArray ♦chemins; 

6 NSString ♦cheminDoc; 

7 chemins = NS Sear chPathForD ire et or ies InDomains ( 

NSDocumentDirectory , NSUserDomainMask , YES); 

8 cheminDoc = [chemins ob j ectAt Index : 0] ; 

9 NSString ♦ soundFilePath = [cheminDoc 

s t r ingBy AppendingPat hComponent :®"monSon. caf"] ; 

10 

11 NSDictionary ♦ rec ordSet t ings = [NSDict ionary 
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di et i onary Wi thOb j ect s AndKey s : 

[NSNumber numberWithlnt : AVAudioQualityMin] , 
AVEncoderAudioQualityKey , 

[NSNumber numberWithlnt : 16] , 

AVEncoderBitRateKey , 

[NSNumber numberWithlnt: 2], 

AVNumberOf ChannelsKey , 

[NSNumber numberWithFloat : 44100 . 0] , 

AVSampleRateKey , 
nil] ; 

NSURL *URLson = [NSURL f ileURLWit hPath : s oundFilePath] ; 
NSError *error = nil; 

audioRecorder = [ [ AV AudioRe cor der alloc] 

initWithURL : URLson 
settings : recordSettings 
error : fterror ] ; 

if (error) NSLog ( @ " Erreur à l'initialisation de l'objet 
audioRecorder : */,<§", [error description]); 

else [audioRecorder prepareToRec ord] ; 


> 


Copier ce code 
^Code web : 397304 


Ne soyez pas effrayés ! Nous allons commenter tout ce code qui, comme vous le verrez, 
n’a rien d’insurmontable. 


Pour des raisons de sécurité, seule une très petite partie du système de fichier est 
accessible en écriture sur un device iOS. Chaque application dispose d’un dossier « Do- 
cuments » dans laquelle elle peut stocker les fichiers qu’elle manipule. Pour accéder à 
ce dossier, il faut dans un premier temps connaître son chemin. C’est la raison d’être 
des instructions des lignes 5 à 9. 

On commence par définir l’objet chemins de classe NSArray, puis l’objet cheminDoc 
de classe NSString : 

NSArray ^chemins; NSString *cheminDoc ; 

Pour trouver le chemin du dossier « Documents », il suffit de faire appel à la méthode 
NSSearchPathForDirectoriesInDomains en lui indiquant que le chemin recherché 
concerne le dossier « Documents » : 


1 chemins = NS Sear chPat hForD ir ect or ie s InDomains ( 

NSDocumentDirectory , NSUserDomainMask , YES); 


Cette instruction n’a rien de compliqué : elle se contente de reprendre le gabarit indiqué 
dans l’aide : 

1 NSArray * NS Sear chPat hForD ir ect or ie s InDomains ( 

2 NSSear chPathD ir ect ory directory. 


347 


CHAPITRE 18. MULTIMÉDIA : LE SON 


3 NSSearchPathDomainMask domainMask , 

4 BOOL expandTilde 

5 ) ; 


en lui indiquant le dossier recherché (NSDocumentDirectory) et l’emplacement de ce 
dossier (NSUserDomainMask). La valeur YES pour le paramètre expandTilde indique 
que les éventuels tildes dans le chemin doivent être transformés en un chemin complet. 
Une fois de plus, ces informations proviennent de la documentation Apple. 

Le NSArray chemins étant initialisé, l’instruction suivante extrait la première informa- 
tion de ce tableau et la stocke dans le NSString cheminDoc. C’est ainsi que cheminDoc 
contient le chemin complet du dossier « Documents » de l’application : 

l| cheminDoc = [chemins ob j ectAt Index : 0] ; 

Le son enregistré sur le device sera stocké dans le fichier « monSon.caf ». 

L’instruction suivante (ligne 9) concatène ce nom avec le chemin du dossier « Docu- 
ments » et stocke le tout dans la variable NSString soundFilePath : 

1 NSString ♦soundFilePath = [cheminDoc 

s t r ingBy AppendingPathComponent :®"monSon. caf"] ; 


Arrivés à ce point dans le code, nous avons un objet NSString nommé soundFilePath 
qui contient le chemin du fichier monSon.caf dans lequel le son sera enregistré. 

Dans l’étape suivante (lignes 11 à 21), nous définissons l’objet recordSettings de type 
NSDictionary qui rassemble tous les paramètres en rapport avec l’enregistrement : 


1 

2 
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NSDictionary ♦recordSettings = [NSDictionary 
die t ionaryWit hOb j e et s AndKey s : 

[NSNumber numberWithlnt : AV AudioQualityMin] , 
AVEncoderAudioQualityKey , 

[NSNumber numberWithlnt : 16] , 
AVEncoderBitRateKey , 

[NSNumber numberWithlnt : 2] , 

AVNumberOf ChannelsKey , 

[NSNumber numberWithFloat : 44100 . 0] , 
AVSampleRateKey , 
nil] ; 


Ce dictionnaire est constitué d’un ensemble de paires objet/clé. Sont ainsi définis : 

- la qualité d’enregistrement : AVEncoderAudioQualityKey, qui est ici initialisé à 
AVAudioQualityMin ; 

- la profondeur d’encodage : AVEncoderAudioQualityKey réglé à 16 bits; 

- le nombre de canaux d’enregistrement : AVNumberOf ChannelsKey pour un enregis- 
trement mono ; 

- la fréquence d’échantillonnage : AVSampleRateKey réglé sur 22050 Hz. 
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Ces termes techniques n'offrent que peu d'intérêt, à moins que vous ne soyez 
férus d'enregistrement audio. Si vous voulez en savoir plus, je vous suggère 
de consulter la page de Wikipédia relative aux fréquences d'échantillonnage. 
Vous pouvez également consulter l’aide Apple pour prendre connaissance des 
différentes qualités d'enregistrement autorisées. Pour cela, reportez-vous à la 
section « Sample Rate Conversion Audio Quality Flags » de l’aide. 


(Fréquence d’échantillonnage A 

[ Code web : 228211 y 

Jusqu’ici, nous avons défini l’adresse du fichier dans lequel le son sera enregistré et les 
paramètres d’enregistrement. Il ne reste plus qu’à préparer le device à l’enregistrement 
en initialisant l’objet audioRecorder. Cette opération va se faire avec la méthode 
initWithURL qui demande trois arguments : 

- l’adresse du son de type NSURL ; 

- le NSDictionary dans lequel se trouvent les paramètres d’enregistrement ; 

- un code d’erreur de type NSError. 

Nous avons bien l’adresse du son au format NSString. . . mais pas au format NSURL. Il 
est donc nécessaire d’effectuer une conversion. Rien de plus simple, grâce à la méthode 

fileURLWithPath : 

l| NSURL *URLson = [NSURL f ileURLWit hPath : s oundFilePath] ; 

La variable error, de type NSError, est ensuite définie : 

1 | NSError *error = nil; 

Nous pouvons (enfin !) initialiser l’objet audioRecorder : 

1 audioRecorder = [ [ AV AudioRe cor der alloc] 

2 initWithURL : URLson 

3 settings : recordSettings 

4 error : terror] ; 

Si cette initialisation produit une erreur, nous l’affichons dans la console : 

1 if (error) NSLog ( @ " Erreur à l'initialisation de l'objet 
audioRecorder : [error description]); 

Bien évidemment, l'instruction NSLog ne fonctionne que dans le simulateur, et 
pas sur les devices. Elle ne servira donc qu'à la mise au point de l'application. 

Si tout se passe bien lors de l’initialisation, la méthode prepareToRecord est appliquée 
à l’objet audioRecorder : 

l| else [audioRecorder prepareToRecord]; 

Cette instruction déclenche la création du fichier monSon. caf et informe iOS que l’ap- 
plication est sur le point de lancer un enregistrement. 
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Écriture du code pour les Rounded Rect Button 

Il ne reste plus qu’à écrire le code attaché aux méthodes action des trois boutons. 
Rassurez- vous, cette tâche va être élémentaire. 

Repérez la méthode enregistre et complétez-la comme suit : 

1 - ( IBAction) enregistre :( id) sender 

2 { 

3 [audioRecorder record]; 

4 } 

Comme vous pouvez le voir, pour commencer l’enregistrement, il suffit d’appliquer la 
méthode record à l’objet audioRecorder. 

Repérez la méthode arrête et complétez-la comme suit : 

1 - ( IBAction) arrête :( id) sender 

2 { 

3 [audioRecorder stop]; 

4 } 


Ici encore, le code utilisé est très simple : pour arrêter l’enregistrement, il suffit d’ap- 
pliquer la méthode stop à l’objet audioRecorder. 

Repérez la méthode j oue et complétez-la comme suit : 
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- ( IBAction) j oue :( id) sender 

{ 

NSError *error; 

audioPlayer = [ [ AVAudioPlayer alloc] 

initWithContent s Of URL : audioRecorder . ur 1 
err or :terror] ; 

audioPlayer . delegate = self ; 
if (error) 

NSLog ( @ " Err or : [error description]); 

else 

[audioPlayer play]; 


Cette méthode est un peu plus longue, mais elle ne présente aucune difficulté. Après 
avoir défini la variable error de type NSError : 

1 | NSError * error ; 

l’objet audioPlayer est initialisé avec la méthode initWithContent sOf URL : 

1 audioPlayer = [[AVAudioPlayer alloc] 

2 initWithContent s Of URL : audioRecorder . ur 1 

3 error : fterror ] ; 
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L'adresse du fichier son est la même que celle qui a été utilisée pour l'enre- 
gistrement. Quoi de plus logique, puisque nous voulons jouer le son qui a été 
enregistré 


L’instruction suivante (ligne 8) indique que les messages en provenance de l’objet 
audioPlayer seront traités dans la classe ViewController. Cette instruction n’est 
pas vraiment obligatoire, car nous ne traitons aucuns des messages envoyés par l’objet 
audioPlayer, mais le code est plus « propre » si elle y est insérée. 

Si l’initialisation de l’objet audioPlayer produit une erreur, elle est affichée (dans le 
simulateur uniquement) : 

1 if (error) 

2 NSLog (@ " Error : [error description]); 

Dans le cas contraire, le son est joué : 


1 else 


[audioPlayer play]; 


2 


Un arrière-plan pour enjoliver l’application 

Maintenant que vous savez à quel point il est simple d’ajouter un arrière-plan à une 
vue, pourquoi ne pas en profiter pour donner un peu d’allure à cette application. 

Procurez-vous une image de 320 x 480 pixels. Si nécessaire, redimensionnez une image 
existante pour qu’elle ait cette taille. Placez cette image dans les ressources de l’appli- 
cation et ajoutez l’instruction suivante au début de la méthode viewDidLoad (dans cet 
exemple, l’image a pour nom « fond0.jpg ») : 

1 self . view . backgroundColor = [[UlColor alloc] 

initWithPatternlmage : [UI Image imageNamed :0"fond0.jpg"]]; 

Lancez l’application sur un device (elle ne fonctionne pas dans le simulateur) et amusez- 
vous à enregistrer tout ce qui vous passe par la tête ! Vous trouverez mon résultat à la 
figure 18.6. 


O 


Pour tous ceux qui se demanderaient d'où provient cette image, il s'agit d'un 
clipart d'Office 2010. 


L’application se trouve dans le dossier audioRecorder. 
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Figure 18.6 - Mon application une fois terminée 


ViewController .h 
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# import CUIKit/UIKit .h> 

# import < A VF oundat ion/ A VF oundat ion . h> 

©interface ViewController : UlViewController < 

AV Audi oRecorderDelegat e , AVAudioPlayerDelegate > 

{ 

AV AudioRecorder ♦audioRecorder ; 

AVAudioPlayer * audioPlayer ; 


- (IBAction) enregistre : (id) sender ; 

- ( IBAction) arrête :( id) sender ; 

- ( IBAction) j oue :( id) sender ; 

©end 


ViewController .m 


1 #import "ViewController .h" 

2 

3 ©implémentation ViewController 

4 
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- ( vo id ) didRe cei veMemory Warning 

{ 

[super didReceiveMemoryWarning] ; 

// Release any cached data, images, etc that aren ' t in use. 

} 

#pragma mark - View lifecycle 

- ( vo id ) viewDidLoad 

{ 

[super viewDidLoad]; 

self . view . backgroundColor = [[UlColor alloc] 

initWithPatternlmage : [UI Image imageNamed : @ " fond0.jpg"]]; 

NSArray ♦chemins; 

NSString ♦cheminDoc; 

chemins = NSSear chPat hForD ir ec t or ie s InDomains ( 
NSDocumentDirectory , NSUserDomainMask , YES); 
cheminDoc = [chemins ob j ect Atlndex : 0] ; 

NSString * s oundFi lePath = [cheminDoc 

s t r ingByAppendingPat hC omponent :8"monSon. caf "] ; 

NSDictionary * re cordSet t ings = [NSDictionary 
di et i onary Wi thOb j ect s AndKey s : 

[NSNumber numberWithlnt : AVAudioQualityMin] , 
AVEncoderAudioQualityKey , 

[NSNumber numberWithlnt : 16] , 

AVEncoderBitRateKey , 

[NSNumber numberWithlnt: 2], 

AVNumberOf ChannelsKey , 

[NSNumber numberWithFloat : 44100 . 0] , 

AVSampleRateKey , 
nil] ; 

NSURL tURLson = [NSURL f ileURLWit hPath : s oundFilePath] ; 
NSError ♦error = nil; 

audioRecorder = [ [ AVAudioRecorder alloc] 

initWithURL : URLson 
settings : recordSettings 
error : terror] ; 

if (error) 

NSLog (@ " Erreur à l'initialisation de l'objet audioRecorder 
: [error description]); 

else 

[audioRecorder prepareToRecord] ; 
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- (void) viewDidUnload 

{ 

[super viewDidUnload]; 

// Release any retained subviews of the main view . 
// e.g. self . myOut let = nil ; 

} 

- (void) viewWill Appear : (B00L) animated 

{ 

[super viewWillAppear : animated] ; 

} 

- (void) viewDidAppear : (B00L) animated 

{ 

[super viewDidAppear : animated] ; 

} 

- (void) viewWillDis appear : (B00L) animated 

{ 

[super viewWillDisappear : animated] ; 

} 

- (void) viewDidDisappear : (B00L) animated 

{ 

[super viewDidDisappear : animated] ; 

} 

- (B00L) shouldAutorotateTo Interface Orientât ion : ( 

UlInterfaceOrientation) interf aceûrientation 

{ 

// Return YES for supported orientations 
return ( int erf ace Or ient at ion ! = 

UIInterfaceOrientationPortraitUpsideDown) ; 

} 

- (IBAction) enregistre : (id) sender 

{ 

[audioRecorder record]; 

} 

- ( IBAction) arrête :( id) sender 

{ 

[audioRecorder stop]; 

} 

- ( IBAction) j oue :( id) sender 

{ 


NSError *error; 

audioPlayer = [ [ AVAudioPlayer alloc] 

initWithContent s Of URL : audioRecorder . ur 1 
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error : terror] ; 

audioPlayer . delegate = self; 
if (error) 

NSLog (@ " Error : [error description]); 

else 

[audioPlayer play]; 

} 

®end 


En résumé 

- Pour jouer des sons sur un device, vous pouvez passer par les « System Sound Ser- 
vices » du framework AudioToolbox. Cette technique est réservée aux sons courts. 
Elle est très simple à mettre en œuvre. 

- Pour jouer des sons sur un device, vous pouvez aussi utiliser un AVAudioPlayer. 
Cette technique peut jouer des sons courts ou longs. Elle repose sur l’utilisation des 
frameworks AVFoundation et AudioToolbox, mais aussi la mise en place du delegate 
AVAudioPlayerDelegate, la définition d’un objet AVAudioPlayer, la mise en place 
de ressources dans l’application pour stocker le fichier audio à jouer et l’utilisation 
de méthodes sur l’objet AVAudioPlayer pour contrôler le son pendant qu’il est joué. 

- Les iPhone, iPod Touch et iPad disposent d’un microphone. Vous pouvez l’uti- 
liser pour enregistrer des éléments audio. Pour cela, vous devez utiliser la classe 
AVAudioRecorderDelegate du framework AVFoundation. 
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Difficulté : — 

Q ue diriez-vous d'exploiter le lecteur vidéo et l'appareil photo qui se cachent dans 
votre device? Apple a bien fait les choses et ces fonctionnalités sont vraiment aisées 
à manipuler en Objective-C. Dans ce chapitre, je vous propose de découvrir comment 
insérer un lecteur vidéo dans vos applications pour lire tout fichier vidéo qui respecte les 
standards H. 264 et MPEG-4 Part 2. Quelques lignes de code sont suffisantes! Pour ne 
pas vous arrêter en si bon chemin, je vous montrerai ensuite comment prendre des photos 
dans une application et les stocker dans l'album photo du device. Là encore, il vous suffira 
d'écrire quelques lignes de code ! 

J'espère vous avoir mis l'eau à la bouche. Tournez vite les pages et découvrez comment 
procéder. 



357 


CHAPITRE 19. MULTIMÉDIA : LIMAGE 


Jouer des éléments vidéo 

Dans cette section, vous allez découvrir comment jouer des vidéos sur un device iOS. 
Cette prouesse réside dans l’utilisation du framework MediaPlayer, et plus particuliè- 
rement de la classe MPMoviePlayerController, incluse dans ce framework. La vidéo 
sera jouée dès l’exécution de l’application. 

Créez une nouvelle application basée sur le modèle Single View Application et 
donnez-lui le nom « videoPlayer » . 

Les fichiers d’extension .mov, .mp4, .mpv et .3gp sont supportés à condition qu’ils 
utilisent un des formats de compression suivants : 

- H. 264 Baseline Profile Level 3.0 video, jusqu’à 640 x 480 pixels, 30 images 
par seconde ; 

- MPEG-4 Part 2 video. 


Implémentation du framework MediaPlayer 

Avant tout chose, il nous faut ajouter le framework MediaPlayer à l’application. Cli- 
quez sur la première icône du volet de navigation, basculez sur l’onglet Build Phases 
et développez la zone Link Binary With Libraries. Cliquez sur l’icône + et ajoutez 
le framework MediaPlayer . framework. 

Cliquez sur ViewController .h dans le volet de navigation et ajoutez une instruction 
import au début du fichier d’en-têtes pour accéder au framework MediaPlayer : 

l| #import <MediaPlayer /MediaP layer . h> 

Tant que vous êtes dans le fichier d’en-têtes, définissez les variables d’instance lecteur, 
de classe MPMoviePlayerController ainsi qu’adresse, de classe NSURL : 

1 MPMo viePlayerCont r ol 1er * lecteur; 

2 NSURL* adresse; 

Définissez enfin la chaîne constante cheminComplet et initialisez-la comme suit : 

1 #define cheminComplet @ "http : //www . siteduzero . com/uploads /f r/ 
ftp/ iphone /coins -arrondis . mp4 " 



Dans cet exemple, la vidéo provient du site de formation Mediaforma et est 
uploadée sur le Site du Zéro. Libre à vous de choisir une autre adresse URL 
ou, pourquoi pas, de placer la vidéo dans les ressources de l'application. 


Le fichier d’en-têtes devrait maintenant ressembler à ceci : 

1 # import <UIKit/UIKit.h> 

2 #import <MediaPlayer /MediaP layer . h> 

3 #define cheminComplet @ "http : //www . siteduzero . com/uploads /fr/ 

ftp/ iphone/ coins -arrondis . mp4 " 
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©interface V iewCont r o 1 1 er : UlViewContr oller 

{ 

MPMoviePlayerController* lecteur ; 

NSURL* adresse; 


®end 


Affichage en mode paysage 

Pour que l’application s’affiche en mode paysage par défaut, vous allez agir sur ses 
« informations de déploiement », c’est-à-dire sur l’écran Summary de l’application. 

Comme à la figure 19.1, cliquez sur l’entrée videoPlayer dans le volet de navigation 
(1), sélectionnez l’onglet Summary dans la partie centrale de la fenêtre (2) et demandez à 
ce que l’application ne s’affiche qu’en mode paysage orienté à gauche. Pour cela, cliquez 
sur Landscape Lef t pour que cette icône apparaisse en noir (3) et, si nécessaire, cliquez 
sur Portrait, Upside Down et/ou Landscape Right pour que ces icônes apparaissent 
en gris (4). 



Figure 19.1 - L’application doit s’afficher en mode paysage 
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Implémentation du lecteur 

Cette application n’utilise aucun contrôle. Interface Builder ne nous sera donc d’au- 
cune utilité. Cliquez directement sur ViewController .m dans le volet de navigation et 
modifiez la méthode viewDidLoad comme suit : 

1 - (void) viewDidLoad 

2 { 

3 [super viewDidLoad]; 

4 adresse = [[NSURL alloc] initWithStr ing : cheminComplet ] ; 

5 lecteur = [ [MPMoviePlayerController alloc] initWithContentURL 

: adresse ] ; 

6 lecteur . view . f rame = CGRectMake (0 , 0 , 480 , 31 0 ) ; 

7 [self . view addSubview : lecteur . view] ; 

8 [lecteur play]; 

9 } 

La ligne 4 transforme la chaîne constante cheminComplet en un objet de classe NSURL 
en utilisant la méthode initWithString et l’affecte à la variable d’instance adresse : 

l| adresse = [[NSURL alloc] initWithString : cheminComplet ] ; 

La ligne 5 initialise la variable d’instance lecteur (c’est-à-dire notre lecteur vidéo) en 
lui affectant l’adresse URL de la vidéo à jouer : 

1 lecteur = [[MPMoviePlayerController alloc] initWithContentURL: 
adresse ] ; 

La ligne 6 définit la taille de la zone dans laquelle sera affichée la vidéo : 
il lecteur . view . f rame = CGRectMake (0 , 0 , 480 , 310 ) ; 



Pour ceux qui auraient la mémoire courte, la fonction CGRectMake () retourne 
un rectangle dont l'emplacement et les dimensions sont passés en argument. 
Les deux premiers paramètres représentent l'abscisse et l'ordonnée du coin 
supérieur gauche du rectangle; les deux derniers la largeur et la hauteur du 
rectangle. 


La ligne 7 ajoute la vidéo à la vue courante : 

1 | [self . view addSubview : lecteur . view] ; 

Enfin, la ligne 8 déclenche la lecture de la vidéo : 

1 I [lecteur play] ; 



Et c'est tout? Cinq instructions suffisent vraiment pour créer un lecteur vidéo 
sur un device iOS ? 
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Eh bien oui. Et c’est bien là toute la puissance de la classe MPMoviePlayerController ! 

Pourquoi ne pas lancer l’application et voir si elle fonctionne. La figure 19.2 représente 
ce que vous devriez obtenir au bout de quelques secondes (ce temps est nécessaire pour 
précharger la vidéo qui, rappelons-le, se trouve sur le Web) : 



Figure 19.2 - La vidéo est lue dans l’application 

Je sens que vous aimeriez aller plus loin avec cette application, c’est pourquoi je vous 
propose de lui ajouter un « observateur d’événements » afin de détecter la fin de la 
vidéo. 

Bien entendu, il ne s'agit là que d'un prétexte pour ajouter une corde de plus 
à votre « arc Objective-C ». Le principe qui va être abordé ici est une variante 
de la gestion événementielle par delegate. Lorsque vous créerez vos propres 
applications, vous pourrez ainsi choisir l'une ou l'autre de ces méthodes pour 
répondre aux événements retournés par un objet. 

Pour définir un observateur d’événements, il faut créer un objet NSNotif icationCenter 
et lui affecter un observateur, associé à l’événement que vous voulez observer. Dans le 
cas qui nous intéresse, l’événement « fin de la vidéo » répond au joli nom de : 

1 | MPMo viePlay erP laybackDidFinishNo t if i cat ion 

Je n'aurais jamais pu trouver ce nom d'événement tout seul. Comment savoir 
quels événements sont associés à un objet particulier? 

En consultant l’aide Apple de la classe correspondante bien sûr. Dans cette section, 
nous nous intéressons à la classe MPMoviePlayerController. C’est donc ici que vous 
trouverez les diverses notifications émises par ces objets. 

Ajoutez l’instruction suivante au début de la méthode viewDidLoad : 

1 [ [NSNot if icat i onCent er def ault Cent er ] addûbserver : self selector 
: Oselector (playbackFinished : ) name : 
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MPMo viePlayerP laybackDidFini shNot if icat ion object :nil] ; 

Cette instruction définit un objet NSNotif icationCenter, lui ajoute un observateur 
de nom playbackFinished pour répondre à l’événement : 

1 I MPMo viePlayerP laybackDidFini shNot if icat ion 


Vous vous en doutez certainement, cette instruction ne se suffit pas à elle-même : il 
faut lui associer une méthode pour traiter la notification lorsqu’elle sera émise. 

Ajoutez le code suivant : 


1 

2 

3 

4 

5 

6 

7 

8 
9 

10 

11 

12 

13 

14 

15 

16 

17 

18 


- (void) playbackFinished : (NSNotification*) notification 

{ 

NSNumber* raison = [[notification userlnfo] ob j e et For Key : 

MPMoviePlayerPlaybackDidF inishReas onüserlnf oKey] ; 
switch ([raison intValue]) 

{ 

case MPMovieFinishReasonPlaybackEnded : 

NSLog(@"La vidéo a été entièrement lue"); 
break ; 

case MPMovieFinishReasonPlaybackError : 

NSLog ( @ " Erreur de lecture"); 
break ; 

case MPMovieFinishReasonUserExited : 

NSLog ( @ " L ' ut il isat eur a mis fin à la vidéo"); 
break ; 
def ault : 
break ; 

} 

} 


Que diriez-vous de détailler un peu ce code? La ligne 3 récupère la valeur asso- 
ciée à la clé MPMoviePlayerPlaybackDidFinishReasonUserlnf oKey. Cette clé donne 
la raison ayant provoqué la fin de la vidéo. En cliquant dans la fenêtre d’aide sur 
MPMoviePlayerPlaybackDidFinishReasonUserlnf oKey puis sur MPMovieFinishReason, 
on obtient les différentes valeurs possibles pour cette clé (figure 19.3). 

Les instructions suivantes testent la valeur de la clé et affichent un message en consé- 
quence dans la console. Bien évidemment, ils ne produiront aucun effet sur un device 
réel. 


Les fichiers de cette application se trouvent dans le dossier videoPlayer. 


[Copier ce 

code 

\ 

(Code web 

: 741683 

J 


ViewController .h 


# import CUIKit/UIKit .h> 

#import <MediaPlayer /MediaPlayer .h> 
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MPMoviePlayerC udio but not video 
U MPMoviePlayerC medutely appear 
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IU How to play audi lePlayerController 
Mow to play audi lePlayerController 
- About AlrPlay 
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0 Resuits 

> Sample Code 

1 Resuits 

► "* MoviePlayer 

► ** HeadsUpUl 

► ^ StitchedStreamPlayer 


: <C 


Fullscreen Controls are displayed by default. 
Available in iOS 3.2 and later. 

Dedared in MPMoviePlayerController .h. 

MPMovieFinishReason 

Constants describmg the reason that playback ended. 

•num < 

MPMovieFinishReasonPlaybackEnded 
MPMovieFinishReasonPlaybackError 
MPMovleFinishReasonUserExited 

>» 

typedef NSlnteger MPMoviePinishReason; 

Constants 

MPMovieFinishReasonPlaybackEnded 

The end of the movie was reached. 

Available In IOS 3.2 and later. 

Declared in MPMoviePlayerController. h. 
MPMovieFinishReasonPlaybackError 
There was an error during playback. 

Available in tOS 3.2 and later. 

Declared in MPMoviePlayorControl 1er .h. 
MPMovierinishReesonUeerExited 
The user stopped playback. 

Available in iOS 3.2 and later. 

Declared m MPMoviePlayerController .h. 

MPMoviePlaybackState 


Figure 19.3 - Les différentes valeurs possibles pour la clé 
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#define cheminComplet © "http : //www . siteduzero . com/uploads /f r/ 
ftp/ iphone/ coins -arrondis . mp4 " 

©interface ViewController : UlViewController 

{ 

MPMoviePlayerController* lecteur ; 

NSURL* adresse; 


©end 


ViewController .m 


1 

2 

3 

4 

5 

6 

7 

8 
9 

10 

11 

12 

13 

14 

15 

16 

17 

18 

19 

20 
21 
22 

23 

24 

25 

26 

27 

28 

29 

30 

31 

32 
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#import "ViewController .h" 

©implémentation ViewController 

- ( void) didRecei veMemoryWarning 

{ 

[super didReceiveMemoryWarning] ; 

// Release any cached data, images , etc that aren't in use. 

} 

#pragma mark - View lifecycle 

- (void) playbackFinished : (NSNotification*) notification 

{ 

NSNumber* raison = [[notification userlnfo] ob j e et For Key : 

MPMoviePlayerPlaybackDidF inishReas onüserlnf oKey] ; 
switch ([raison intValue]) 

{ 

case MPMovieF inishReas o nPlaybackEnded : 

NSLog(©"La vidéo a été entièrement lue"); 
break ; 

case MPMovieFinishReasonPlaybackError : 

NSLog (©" Erreur de lecture"); 
break ; 

case MPMo vieFinishReas onUs erExi t ed : 

NSLog ( © " L ' ut il isat eur a mis fin à la vidéo"); 
break ; 
def ault : 
break ; 

} 


- ( void) viewDidLoad 

{ 

[super viewDidLoad]; 
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[ [NSNot if i cat ionCent er def aultCenter] addObserver : self 
selector : Oselector (playbackFinished : ) name : 

MPMo viePlay erPlaybackDidFinishNo t if i cat ion object :nil] ; 

adresse = [[NSURL alloc] initWithString : cheminComplet ] ; 
lecteur = [ [MPMo viePlayerContr oller alloc] initWithContentURL 

: adresse ] ; 

lecteur . view . f rame = CGRectMake (0 , 0 , 480 , 310 ) ; 

[self . view addSubview : lecteur . view] ; 

[lecteur play]; 

} 

- ( vo id ) viewDidUnload 

{ 

[super viewDidUnload]; 

// Release any retained subviews of the main view . 

// e.g. self . myOutlet = nil; 

} 

- (void)viewWillAppear:(B00L) an i mat ed 

{ 

[super viewWillAppear : animated] ; 

} 

- (void) viewDidAppear : (B00L) animated 

{ 

[super viewDidAppear : animated] ; 

} 

- (void)viewWillDisappear:(B00L) animated 

{ 

[super viewWillDisappear : animated] ; 

} 

- (void) viewDidDisappear : (B00L) animated 

{ 

[super viewDidDisappear : animated] ; 

} 

- (B00L) shouldAutorotateToInterfaceOrientation : ( 

UI Interface Orientât ion) interface Orientât ion 

{ 

return ( inter f aceOrientat ion != 

UI Interface Orientât ionLands capeRight ) ; 

} 

®end 
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Prendre des photos 

Dans un chapitre précédent, vous avez appris à utiliser un objet pour choisir des images 
dans l’album photo et à les afficher sur l’écran. Nous allons nous appuyer sur ce projet 
pour manipuler l’appareil photo contenu dans un device iOS. Après validation par 
l’utilisateur, les photos seront stockées dans l’album photo. 


Création du projet 

Définissez un nouveau projet basé sur le modèle Single View Application et donnez- 
lui le nom « appPhoto ». 

Une fois le projet créé, cliquez sur MainStoryboard. storyboard dans le volet de navi- 
gation, puis ajoutez un contrôle Rounded Rect Button et un contrôle Label. Double- 
cliquez sur le Rounded Rect Button et donnez-lui le nom « Prendre une photo ». 
Double-cliquez sur le contrôle Label et tapez « Appuyez sur le bouton pour prendre 
une photo ». 

Redimensionnez et repositionnez ces contrôles pour obtenir quelque chose ressemblant 
à la figure 19.4. 


as 


Prendre une photo 


Appuyez sur le bouton 
pour prendre une photo 


Figure 19.4 - Disposez vos contrôles de cette manière 

Vous allez maintenant ajouter une image de fond d’écran au projet. Je vous rappelle 
que cette image doit faire 320 x 480 pixels. 
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Cliquez du bouton droit sur l’icône appPhoto, affichée dans la partie supérieure du 
volet de navigation et sélectionnez New Group dans le menu contextuel. Renommez le 
nouveau dossier « Resources » et faites glissez l’image à utiliser en fond d’écran depuis 
le finder jusqu’au dossier Resources du volet de navigation. 

À la fin du glisser-déposer, lorsque vous relâchez le bouton gauche de la souris, une boîte 
de dialogue intitulée Choose options for adding these files est affichée. Assurez- 
vous que la case Copy items into destination group’s folder est cochée (ainsi, 
l’image sera copiée dans l’application), puis cliquez sur Finish. 

Une fois l’image insérée dans les ressources, le volet de navigation devrait ressembler à 
la figure 19.5. 


appPhoto 

LJ 1 target. iOS SDK 5.0 
▼ appPhoto 

D 

[»] fond-ap-photo.jpg 

h) AppDelegate.h 
m AppDelegate.m 
£ MainStoryboard.storyboard 
[h] ViewController.h 
[ml ViewController.m 
► Q Supporting Files 

► Frameworks 

► Ù Products 


Figure 19.5 - Le volet de navigation du projet 


Liaison des contrôles au code 

Vous allez maintenant relier les contrôles Label et Rounded Rect Button au code. 

En créant : 

- un outlet pour le contrôle Label, il sera possible d’afficher le nombre de photos prises 
avec l’application ; 

- une action pour le Rounded Rect Button, il sera possible de déclencher l’appareil 
photo sur un simple clic de l’utilisateur. 

Cliquez sur Show the Assistant editor dans la barre d’outils de Xcode, puis contrôle- 
glissez-déposez le Label de la zone d’édition dans le fichier ViewController.h, juste 
au-dessus du @end final et créez l’outlet inf os. 

Contrôle-glissez-déposez le Rounded Rect Button de la zone d’édition dans le fichier 
ViewController.h, juste au-dessus du @end final et créez l’action prendPhoto, déclen- 
chée sur l’événement Touch Up Inside. 

Cette application va utiliser un UlImagePickerController (nécessaire pour la prise de 
vues) et un compteur de prises de vues. Pour mettre en place ces deux objets, définissez 
les variables d’instance suivantes : 

l| UlImagePickerController *picker; 
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2 int compteur ; 


Si vous avez suivi mes consignes, le fichier d’en-têtes devrait avoir l’allure suivante : 


1 

2 

3 

4 

5 

6 
7 


# import <UIKi t /UIKi t ,h> 

©interface ViewContr oller : UI ViewCont r o 1 le r 

{ 

UlImagePickerController *picker; 
int compteur ; 


9 

10 

11 

12 


Sproperty (weak , nonatomic) IBOutlet UILabel *infos; 
- (IBAction) prendPhoto : (id) sender ; 

Oend 


Écriture du code de l’application 

Vous allez maintenant modifier le code de l’application. Cliquez sur ViewController .m 
dans le volet de navigation et complétez la méthode viewDidLoad comme suit : 

1 - (void) viewDidLoad 

2 { 

3 [super viewDidLoad]; 

4 self . view . backgroundColor = [[UlColor alloc] 

init Wit hPat t ernlmage : [UI Image imageNamed : @ " fond -ap -photo . 

jpg"U ; 

5 compteur = 0 ; 

6 } 

L’instruction de la ligne 4 indique que l’application utilisera l’image f ond-ap-photo . jpg 
en arrière-plan de l’application. 

L’instruction de la ligne 5 initialise la variable int compteur à 0. Cette variable sera 
utilisée pour comptabiliser le nombre de photos prises dans l’application. Il est donc 
tout à fait normal de l’initialiser à 0 au lancement de l’application. 

Vous allez maintenant définir les instructions à exécuter lorsque l’utilisateur appuie sur 
le Rounded Rect Button. Localisez la méthode prendPhoto et complétez-la comme 
suit : 

1 - ( IBAction) prendPhoto :( id) sender 

2 { 

3 picker = [[UlImagePickerController alloc] init]; 

4 picker . delegate = self; 

5 picker . sourceType = UIImagePickerControllerSourceTypeCamera ; 

6 [self pre sentModalViewContr oller : picker animated : YES] ; 

7 } 
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L’instruction de la ligne 3 définit l’objet UlImagePickerController picker et l’ini- 
tialise : 

l| picker = [[UlImagePickerController alloc] init]; 

L’instruction de la ligne 4 indique que les événements liés à l’UIImagePickerController 
seront gérés dans cette classe. 

I | picker . delegate = self ; 

La ligne 5 indique que les données manipulées par l’UIImagePickerController pro- 
viendront de l’appareil photo : 

l| picker . sourceType = UIImagePickerControllerSourceTypeCamera ; 

Enfin, la ligne 6 définit le mode d’affichage de l’UIImagePickerController : 
l| [self presentModalViewController : picker animated : YES] ; 

Encore une fois, ces instructions ne viennent pas de mon ima- 
gination prolixe, mais plutôt de l'aide Apple sur le protocole 
UIImagePickerControllerDelegate et sur la classe UlViewController. 
Si vous le souhaitez, je vous invite à parcourir ces deux pages d'aide pour 
approfondir le sujet. 

II se peut qu’un triangle « Attention » de couleur jaune soit affiché en face de l’instruc- 
tion picker .delegate = self;. Si tel est le cas, cliquez dessus pour prendre connais- 
sance du problème. Voici ce qui est affiché : 

Assigning to ’ id <UINavigat ionCont r ol lerDelegat e . 

UI ImagePi ckerCont ro llerDelegate > ’ from incompatible type ’ 
appPhot oViewC ont ro lier *’ 



Ce type d’erreur a déjà été rencontré dans ce livre. Il signifie que vous devez ajouter 
un delegate (un gestionnaire d’événements) pour UINavigationControllerDelegate 
et UIImagePickerControllerDelegate. 

Retournez dans le fichier ViewController .h et modifiez la déclaration de l’interface 
comme suit : 


1 


©interface appPhot oViewContr oller : UlViewController < 
UINavigationControllerDelegate , 

UI ImagePi ckerCont rollerDelegate > 

{ 

} 


Vous pouvez retourner dans le fichier ViewController .m et constater que l’avertisse- 
ment a disparu. 

Puisque nous venons d’indiquer que les événements générés par UlImagePickerController 
vont être gérés dans la classe appPhoto, nous allons écrire le code correspondant aux 
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deux événements susceptibles de se produire : didFinishPickingMediaWithlnf o et 
imagePickerControllerDidCancel. 



Une fois encore, ces deux événements ont été trouvés dans l'aide Apple, dans 
la section consacrée au protocole UIImagePickerControllerDelegate. 
Quoi de plus normal, puisque nous nous intéressons aux événements générés 
par un UlImagePickerController ? 


Commencez par définir la méthode didFinishPickingMediaWithlnf o : 

1 - ( void) imageP ickerC ont ro lier :( UI ImageP ickerContro lier * ) 

Picker didFinishPi ckingMediaWit hlnf o : ( NSDic t ionary *)info 

2 { 

3 Ullmage *img = [info ob j ec t For Key : 

UI ImageP ickerC ont r o lier Or iginal Image ] ; 

4 UI ImageWrit eToSavedPhot os Album ( img , self, Sselector ( image : 

didFinishSavingWithError : contextlnfo : ) , nil) ; 

5 [[Picker parent ViewContro lier ] 

dis mi s sModalViewC ont ro lier Animât ed : YES] ; 

6 } 

Lorsqu’une photo a été prise, la méthode didFinishPickingMediaWithlnf o est exé- 
cutée et l’objet info de classe NSDictionary lui est transmis. La photo se trouve dans 
la clé UlImagePickerControllerOriginalImage de l’objet info. Pour la récupérer, 
on envoie un message à l’objet info ([info. . .) en lui demandant d’accéder à la clé 
(objectForKey:) UlImagePickerControllerOriginalImage. Cet objet est mémorisé 
dans l’objet img de classe Ullmage : 

1 Ullmage ♦img = [info objectForKey: 

UI ImageP ickerC ont roi 1er Or iginal Image ] ; 

On utilise la méthode UIImageWriteToSavedPhotosAlbum pour sauvegarder la photo 
dans l’album photo : 

1 UI ImageWrit eToSavedPhot os Album ( img , self, 0 select or ( image : 
didF inishSavingWi thErr or : contextlnfo : ) , nil);} 

Quatre paramètres sont transmis à cette méthode. 

1. La photo : img. 

2. L’objet pour lequel une méthode sera exécutée après la sauvegarde dans l’album. 
Le mot self signifie que la méthode à appeler se trouve dans la classe. 

3. Le nom de la méthode à exécuter lorsque la sauvegarde dans l’album a été faite : 
Sselector (image : didFinishSavingWithError : contextlnfo : ). 

4. Un éventuel pointeur vers des données à passer à la méthode : nil. Ici, aucun 
pointeur n’est passé. 

La dernière instruction supprime la vue de la photo qui vient d’être prise : 


370 


PRENDRE DES PHOTOS 


1 [[Picker parentViewContr oller ] 

dismissModalViewControllerAnimated : YES] ; 

Lorsqu’une photo a été prise, l’utilisateur peut annuler sa sauvegarde dans l’album en 
appuyant sur le bouton Cancel. La méthode imagePickerControllerDidCancel est 
alors exécutée : 

1 - (void) imagePickerControllerDidCancel : ( UI ImagePickerContr oller 

*) Picker 

2 { 

3 [[Picker parentViewController] 

di s mi s sModal ViewCont r oller Animât ed : YES ] ; 

4 } 

L’instruction contenue dans cette méthode a déjà été rencontrée dans la méthode pré- 
cédente, did.Finish.PickingMediaWith.Inf o. Elle supprime la vue de la photo qui vient 
d’être prise. 

Rappelez- vous, dans la méthode didFinishPickingMediaWithlnf o, on a utilisé la mé- 
thode UIImageWriteToSavedPhotosAlbum pour enregistrer la photo qui vient d’être 
prise dans l’album photo. Dans cette méthode, nous avons indiqué que la méthode 
didFinishSavingWithError devait être exécutée juste après la sauvegarde dans l’al- 
bum photo. Pour en terminer avec le code, il reste donc à écrire cette méthode : 

1 - ( vo id ) image :( UI Image ♦limage didFini shSavingWi thErr or : ( 

NSError *)error cont ext Inf o : ( void *) contextlnf o 

2 { 

3 compteur++; 

4 if (compteur == 1) 

5 infos.text = © " 1 photo ajoutée à l'album photo"; 

6 else 

7 infos.text = [NSMutableString s t r ingWithFormat : © " ’/, i '/,©", 

compteur, ©"photos ajoutées à l'album photo."]; 

8 } 

Cette méthode est utilisée pour modifier le texte affiché dans le contrôle Label. Après 
avoir incrémenté le compteur de prises de vues avec compteur++ ; , la valeur du compteur 
est testée. Si une seule photo a été prise, le contrôle Label est mis à jour comme suit : 

1 if (compteur == 1) 

2 infos.text = ©"1 photo ajoutée à l'album photo"; 

Si le compteur est différent de 1, cela signifie que plusieurs photos ont été prises. Le 

message est donc légèrement différent : 

1 else 

2 infos.text = [NSMutableString s tr ingWithFormat :©"*/, i '/,©", 

compteur, ©"photos ajoutées à l'album photo."]; 

Comme vous le voyez, le texte affiché dans le Label (infos.text) est obtenu en 
créant un objet NSMutableString ([NSMutableString . . . ) dans lequel on concatène 
(stringWithFormat : ) un entier et une chaîne (@"°/,i L’entier est la valeur de 
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la variable compteur. La chaîne est spécifiée dans le troisième paramètre (©"photos 
ajoutées à l’album photo."). 

L’application est entièrement fonctionnelle. Bien entendu, elle ne peut s’exécuter que 
sur un device réel. Si vous essayez de prendre une photo dans le simulateur iOS, une 
erreur sera affichée dans la console et l’application prendra fin. 


Cette application se trouve dans le dossier appPhoto. 


Copier ce code 

'N 

[Code web : 497045 

J 


ViewController .h 


4 

5 

6 

7 

8 
9 

10 

11 

12 


# import CUIKit/UIKit .h> 

©interface ViewController : UlViewController < 
UINavigationControllerDelegate , 
UlImagePickerContr ollerDe légat e > 

{ 

UlImagePickerController *picker; 
int compteur ; 

} 

©property (weak , nonatomic) IBOutlet UILabel *infos; 
- (IBAction) prendPhoto : (id) sender ; 

©end 


ViewController .m 


1 #import "ViewController .h" 

2 

3 ©implémentation ViewController 

4 ©synthesize infos; 

5 

6 - ( void) didRecei veMemoryWarning 

7 { 

8 [super didReceiveMemoryWarning] ; 


9 


// Release any cached data. 

images , ei 

c that 

aren ' t in use . 

10 

> 





11 






12 

# P 

ragma mark - View lifecycle 




13 






14 

- 

(void) viewDidLoad 




15 

{ 





16 


[super viewDidLoad]; 




17 


self . view . backgroundColor = 

[ [UlColor 

alloc] 




initWithPatternlmage : [UI 

Image imag 

eNamed 

© " fond -ap -photo 



jpg"]] ; 




18 


compteur = 0 ; 
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32 
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} 

- ( vo id ) imagePicker Cont r oller : ( UI ImagePickerCont r ol 1er *) 

Picker didFinishPi ckingMediaWi thlnf o : ( NSDi et ionary *)info 

{ 

Ullmage * img = [info ob j e et ForKey : 

UI ImagePickerCont roi 1er Original Image] ; 

UI ImageWrit eToSavedPhot os Album ( img , self, Oselector ( image : 

didFinishSavingWit hEr r or : contextlnfo :) , nil); 

[[Picker parentViewController] 

di s mi s sModal ViewCont r oller Animât ed : YES ] ; 

} 

- ( vo id ) image :( UI Image *) image didFini shSavingWi thErr or : ( 

NSError *)error cont ext Inf o : ( void ♦) contextlnfo 

{ 

compteur ++ ; 
if (compteur == 1) 

infos.text = @ " 1 photo ajoutée à l'album photo"; 
else 

infos.text = [NSMutableString s tringWithFormat i 

compteur, ©"photos ajoutées à l'album photo."]; 

} 

- ( vo id ) viewDidUnload 

{ 

[self set Inf os : nil ] ; 

[super viewDidUnload]; 

// Release any retained subviews of the main view. 

// e.g. self . myOutlet = nil; 

} 

- (void) imagePi ckerC ont r o llerD idCance 1 : ( UI ImagePickerContr oller 

*) Picker 

{ 

[[Picker parentViewController] 

dismissModalViewControllerAnimated : YES] ; 

} 

- (void) viewWillAppear : (B00L) animated 

{ 

[super viewWillAppear : animated] ; 

} 

- (void) viewDidAppear : (B00L) animated 

{ 

[super viewDidAppear : animated] ; 

} 


- (void)viewWillDisappear:(B00L) animated 
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62 

63 

64 
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67 
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69 

70 

71 

72 
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75 

76 

77 

78 

79 

80 
81 
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{ 

[super viewWillDisappear : animated] ; 

} 

- (void) viewDidDisappear : (B00L) animated 

{ 

[super viewDidDisappear : animated] ; 

} 

- (B00L) shouldAutorotateTo Interface Orientât ion : ( 

UlInterfaceOrientation) interf aceûrientation 

{ 

// Return YES for supported orientations 
return ( int erf ace Or ient at ion ! = 

UIInterfaceOrientationPortraitUpsideDown) ; 

} 

- (IBAction) prendPhoto : (id) sender 

{ 

picker = [ [UlImagePickerController alloc] init]; 

picker . delegate = self; 

picker . sourceType = UIImagePickerControllerSourceTypeCamera ; 
[self pre sentModalViewCont roller : picker animated : YES] ; 

} 

®end 


En résumé 

- Pour jouer des vidéos sur un device, vous utiliserez le framework MediaPlayer, et plus 
particulièrement la classe MPMoviePlayerController, incluse dans ce framework. 

- La méthode play déclenche la lecture de la vidéo. 

- L’événement MPMoviePlayerPlaybackDidFinishNotif ication permet de se tenir 
informé sur l’état de la vidéo (erreur de lecture, arrêt par l’utilisateur, vidéo entiè- 
rement lue). 

- Les fichiers d’extension .mov, .mp4, .mpv, et . 3gp sont supportés, à condition qu’ils 
utilisent un des formats de compression H. 264 Baseline Profile Level 3.0 video 
ou MPEG-4 Part 2 video. 

- L’objet UlImagePickerController permet de choisir des images dans l’album photo 
et de les afficher sur l’écran. 

- En affectant la valeur UIImagePickerControllerSourceTypeCamera à la propriété 
sourceType d’un tel objet, il est très simple de prendre des photos à partir d’une ap- 
plication. Une fois la photo prise, la méthode didFinishPickingMediaWithlnf o est 
exécutée. Il suffit alors d’utiliser la méthode UIImageWriteToSavedPhotosAlbum : 
UIImageWriteToSavedPhotosAlbum pour sauvegarder la photo dans l’album photo. 
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Accéléromètre 


Difficulté : _ 

L es iPhone, iPod Touch et iPad sont équipés d'un accéléromètre qui leur permet de 
déterminer leur orientation par rapport au sol. Dans ce chapitre, je vais vous montrer 
comment utiliser les données renvoyées par l'accéléromètre pour afficher l'inclinaison 
du device et détecter s'il a été agité. 

Cela vous tente? Allons-y de ce pas ! 
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Mise en place de l’application 

Avant de commencer 

Les accélérations détectées par l’accéléromètre consistent en trois valeurs flottantes qui 
représentent les trois axes du device, comme indiqué à la figure 20.1. 



Figure 20.1 - Les trois axes du device 

Pour obtenir ces informations, vous utiliserez la classe UIAccelerometer. Un coup 
d’œil à l’aide Apple montre que les événements générés par les objets de cette classe se 
font via le protocole UIAccelerometerDelegate. Un autre coup d’œil à l’aide Apple 
sur le protocole UIAccelerometerDelegate montre que la méthode événementielle à 
utiliser pour recevoir les données relatives à l’accélération est didAccelerate. 

Il ne reste plus qu’à implémenter un objet de la classe UIAccelerometer et à gérer les 
événements renvoyés par cet objet dans la méthode didAccelerate pour connaître la 
position du device. 


Définition de l’interface de l’application 


Définissez un nouveau projet de type Single View Application et donnez-lui le nom 
« accelerometre ». 

Une fois le projet créé, cliquez sur MainStoryboard. storyboard dans le volet de na- 
vigation. Ajoutez un contrôle Label à la vue de l’application. Double-cliquez dessus 
et tapez « Accéléromètre » au clavier. Choisissez une police à votre convenance et un 
corps élevé pour que ce Label fasse office de titre (pour l’exemple, j’ai choisi une police 
Helvetica de corps 43). 



Pour modifier la police et le corps du Label, cliquez sur le Label dans le 
canevas (1), affichez l'inspecteur des attributs en cliquant sur l'icône Show 
the Attributes inspector dans le volet des utilitaires (2), puis agissez 
sur le paramètre Font (3), comme indiqué à la figure 20.2. 
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Figure 20.2 - Vous pouvez modifier la police et le corps du Label 


Insérez quatre autres Label dans la partie inférieure de la vue. Déplacez-les et alignez- 
les pour obtenir quelque chose ressemblant à la figure 20.3. 


EB 


Accéléromètre 


Label 

Label 

Label 

Label 


Figure 20.3 - Ajoutez des Label et disposez-les de la sorte 
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Liaison des contrôles au code 


Pour que l’application puisse afficher des informations dans les quatre derniers Label, 
vous devez établir un lien entre l’interface et le code. 

Affichez côte à côte la zone d’édition et le fichier ViewController .h en cliquant sur 
l’icône Show the Assistant editor dans la barre d’outils. 


Contrôle-glissez-déposez tour à tour les quatre derniers Label et définissez les outlets 
x, y, z et mouvement. Le fichier ViewController .h doit maintenant ressembler à ceci : 


1 

2 

3 

4 

5 

6 
7 


# import CUIKit/UIKit .h> 


^interface ViewController : 
Sproperty (weak , nonatomic) 
Sproperty (weak, nonatomic) 
(Sproperty (weak, nonatomic) 
Oproperty (weak, nonatomic) 


UlViewController 
IBOutlet UILabel *x; 

IBOutlet UILabel ♦y; 

IBOutlet UILabel *z ; 

IBOutlet UILabel ♦mouvement; 


9 ®end 


Écriture du code 

L’interface et le fichier d’en-têtes étant définis, il ne reste plus qu’à écrire un peu de 
code pour faire fonctionner tout ce petit monde. Cliquez sur ViewController .m dans 
le volet de navigation. 

Dans un premier temps, vous allez ajouter un arrière-plan à l’application. Définissez 
un dossier Resources dans l’arborescence de l’application, procurez-vous une image de 
320 x 480 pixels et ajoutez-la à ce dossier. 

Pour que l’image d’arrière-plan s’affiche dès l’ouverture de l’application, ajoutez l’ins- 
truction suivante dans la méthode viewDidLoad (cette instruction suppose que l’image 
d’arrière-plan a pour nom « gyro.jpg ») : 

1 self . view . backgroundColor = [[UlColor alloc] 

init Wit hPat t ernlmage : [UI Image imageNamed :0"gyro.jpg"]]; 

Vous allez maintenant définir un objet de classe UIAccelerometer et l’initialiser. Com- 
plétez la méthode viewDidLoad comme suit : 

1 - (void) viewDidLoad 

2 { 

3 [super viewDidLoad]; 

4 self . view . backgroundColor = [[UlColor alloc] 

init Wit hPatt ernlmage : [UI Image imageNamed :®"gyro.jpg"]]; 

5 UIAccelerometer ♦testAccel = [UIAccelerometer 

sharedAccelerometer ] ; 

6 test Accel . delegate = self; 

7 test Accel . updatelnterval = 0 . If ; 

8 [mouvement set Text : <9 " Le device est calme"]; 
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9 | } 

À la ligne 5, nous définissons l’objet testAccel de type UIAccelerator. Cet objet est 
initialisé avec la méthode sharedAccelerometer, comme indiqué dans la documenta- 
tion Apple : 

1 UIAccelerometer ♦testAccel = [UIAccelerometer 
sharedAccelerometer] ; 

La ligne 6 indique que les événements relatifs à l’objet testAccel seront traités dans 
la classe courante, c’est-à-dire dans la classe de la vue : 

l| test Accel . delegate = self; 

À la ligne 7, nous utilisons la propriété update Int erval pour définir la période de la 
mise à jour des données fournies par l’accéléromètre. Ici, tous les 1/10 seconde : 

l| test Accel . updatelnterval = 0 . If ; 

Enfin, la ligne 8 affiche le message « Le device est calme » dans le Label mouvement 
pour indiquer que le device n’est pas agité : 

l| [mouvement setText : @ " Le device est calme"]; 

Si je me souviens de ce qui a été dit au début de cette section, il est néces- 
saire d'implémenter le protocole UIAccelerometerDelegate. Est-ce qu'il ne 
faudrait pas agir sur le fichier d'en-têtes pour cela ? 

Tout à fait exact. D’ailleurs, le message d’avertissement affiché en face de la ligne 
testAccel . delegate = self; (figure 20.4) le confirme : 

- (void)viewDidLoad 

I < 

self .view. backgroundColor ■ [[UlColor alloc] mltvnthPat ternlmage: [Ullmage im»geNa«ied:f“gyro. )pg M ] J ; 

UIAccelerometer «tt est Accel = [UIAccelerometer sharedAccelerometer]; 

i. testAccel* de légat - = ■ Aivignmg to 'id<UIAtc*Wom«it*rD»l*gM«>' Irom mtompatibl* typ* atc*l»roiti»tr*V**wCoorrolUf •* 

test Acc el» updatelnterval = 0. 1 f ; 
ïnouvement setTextsf'Le device est 'calme'"]; 

[super viewDidLoad] ; 

I > 



Figure 20.4 - Un message d’erreur apparaît 


Cliquez sur ViewController .h dans le volet de navigation et ajoutez la référence au 
delegate dans l’instruction Sinterface : 


1 

2 

3 

4 


Sinterface accelerometreViewController 
UIAccelerometerDelegate > 

{ 

} 


UlViewController < 


En consultant la documentation Apple relative à UIAccelerometerDelegate, vous 
verrez que la méthode didAccelerate est appelée lorsque de nouvelles données issues 
de l’accéléromètre sont disponibles. Définissez cette méthode comme suit : 
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1 

2 

3 

4 

5 

6 

7 

8 
9 

10 

11 

12 

13 

14 

15 

16 

17 

18 

19 

20 
21 


- (void) accelerometer : (UIAccelerometer ♦) accelerometer 
didAccelerate : ( UI Accélérât ion *) accélération 

{ 

if ( f absf ( acce lerat ion . x) > 1.5 II f absf ( accélérât ion . y ) > 1. 
5 II fabsf (acceleration.z) > 1.5) 

{ 

[mouvement setText : @ " J ' ai détecté une secousse"]; 
if (temporisation == 0) 
temporisation = 1; 

} 

x . t ext = [NS St r ing s t r ingWi thFormat : @ " */,<§ '/,f",0"X =", 
accélération . x] ; 

y . t ext = [NS St ring s tr ingWi thFormat */,<§ '/ t f",0"Y =", 
accélération . y] ; 

z . t ext = [NS St ring s tr ingWi thFormat : 0 " ’/,@ '/,f",@"Z =", 
acceleration.z] ; 

if (temporisation > 0) 
temporisation++; 
if (temporisation == 30) 

{ 

[mouvement setText : 8"Le device est calme"]; 
temporisation = 0; 

} 

} 


N’ayez crainte, il n’y a rien de bien méchant dans cette méthode ! 


Si le gabarit de la méthode vous semble compliqué, sachez qu’il a été automatiquement 
proposé par Xcode dès la saisie du mot accelerometer, comme le montre la figure 


20.5. 


-(v oid)accelerometer : (UIAccelerometer ♦)accelerometer didAccelerate: (UIAcceleration *) accélération 

t 
> 


M accelerometer : (UIAccelerometer *) accelerometer didAccelerate : (UIAcceleration *)acceleration 


□ accessibilityDec rement 

□ accessibi lityE LementDidBecomeFocused 

□ accessibi lityE lementDidLoseFocus 
H3 accessibilitylncrement 


Figure 20.5 - Xcode vous propose automatiquement le gabarit de la méthode 


Les accélérations selon les axes X, Y et Z sont accessibles dans les propriétés x, y et 
z de l’objet accélération. L’instruction de la ligne 3 teste si l’accélération du device 
est supérieure à 1,5 selon un des axes : 

1 if ( f absf ( accélérât ion . x) > 1.5 II f absf ( accélérât ion . y ) > 1.5 
Il f absf ( accélérât ion . z ) > 1.5) 

Dans ce cas, le device a été agité, et un texte est affiché en conséquence dans le Label 
mouvement : 


380 



ECRITURE DU CODE 


l| [mouvement setText : @ " J ' ai détecté une secousse"]; 

Remarquez l'utilisation de la fonction fabsf () qui renvoie la valeur absolue 
de son argument. En d'autres termes, l'argument privé de son signe. L'ac- 
célération peut en effet être négative. En la privant de son signe, il est plus 
facile de tester si elle dépasse une certaine limite et ainsi décréter qu'il y a eu 
une agitation du device. 

Rappelez- vous : la mise à jour des quatre Labels se fait 10 fois par seconde. Il est donc 
nécessaire de mettre en place un artifice pour que le texte « J’ai détecté une secousse » 
reste affiché plus longtemps, sans quoi il sera pratiquement impossible de le voir. C’est 
le rôle des deux instructions qui suivent : 

1 if (temporisation == 0) 

2 temporisation = 1; 

La variable temporisation vaut 0 par défaut. Elle indique que le device n’a pas été 
agité. Elle est mise à 1 pour indiquer que le device vient d’être agité. 

Les lignes 10 à 12 affichent les valeurs des accélérations dans les labels x, y et z : 

1 x . text = [NSString s t r ingWithFormat : @ " '/, @ , /,f",<8"X =", ac celer at ion . 

x] ; 

2 y . text = [NSString s tr ingWithFormat : @ " ’/,<§ , /,f",<8"Y =", ac celer at ion . 

y] ; 

3 z . text = [NSString s tr ingWithFormat : @ " ’/,@ */,f",@"Z = ", ac celer at ion . 

z] ; 

Il n’y a pas grand-chose à dire au sujet de ces instructions. D’une façon très classique, 
la méthode str ingWithFormat est utilisée pour concaténer deux éléments (ici, un texte 
et un flottant) et les convertir en un NSString. 

Le bloc d’instructions suivant est plus intéressant. C’est lui qui se charge d’afficher le 
texte « J’ai détecté une secousse » pendant trois secondes. Si la variable temporisation 
est supérieure à 0, on l’incrémente : 

1 if (temporisation > 0) 

2 temporisation++ ; 

Si elle a pour valeur 30, ou en d’autres termes, si elle est passée une trentaine de fois 
par ce code (28 exactement), cela signifie qu’environ 3 secondes se sont écoulées depuis 
l’affichage du texte « J’ai détecté une secousse » dans le Label : 

1 | if (temporisation == 30) 

Dans ce cas, le texte « Le device est calme » est affiché dans ce même Label et la 
variable temporisation est mise à 0, en attendant que le device soit agité une nouvelle 
fois : 

1 { 

2 [mouvement setText : ® "Le device est calme"]; 
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3 temporisation = 0; 

4 } 


Pour que ce code fonctionne, deux petites lignes doivent être ajoutées. 

La variable temporisation doit être initialisée à 0 dans la méthode viewDidLoad : 


- (void) viewDidLoad 

{ 


temporisation 


0 ; 


La variable temporisation doit être déclarée dans le fichier d’en-têtes : 


î 

2 

3 

4 

5 


@ interface accelerometreViewController 
UIAccelerometerDelegate > 

{ 

int temporisation; 

} 


UlViewController < 


Ça y est, l’application est entièrement fonctionnelle. Vous pouvez la lancer (pas dans 
le simulateur, évidemment !). La figure 20.6 représente ce que j’ai obtenu. 



Figure 20.6 - Mon application est terminée et fonctionnelle 
Cette application se trouve dans le dossier accelerometre. 
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j Copier ce code 
l Code web : 370619 


ViewController .h 


1 

2 

3 

4 

5 

6 

7 

8 
9 

10 

11 

12 

13 


# import CUIKit/UIKit .h> 


©interface ViewController : UlViewController < 
UI AccelerometerDelegate > 

{ 

int temporisation; 

} 


@pr opert y 
@pr opert y 
@pr opert y 
@pr opert y 


(weak , nonatomic) 
(weak , nonatomic) 
(weak, nonatomic) 
(weak, nonatomic) 


IBOutlet UILabel 
IBOutlet UILabel 
IBOutlet UILabel 
IBOutlet UILabel 


*x ; 

*y ; 

*z ; 

* mouvement ; 


©end 


ViewController .m 


1 

2 

3 

4 

5 

6 
7 


#import "ViewController . h" 

©implémentation ViewController 
©synthesize x; 

©synthesize y; 

©synthesize z ; 

©synthesize mouvement; 


9 

10 

11 

12 

13 

14 

15 

16 

17 

18 

19 

20 

21 

22 

23 

24 

25 


- ( vo id ) didRe cei veMemory Warning 

{ 

[super didReceiveMemoryWarning] ; 

// Release any cached data, images, etc that aren ' t in use. 

} 

#pragma mark - View lifecycle 

- ( void ) viewDidLoad 
{ 

[super viewDidLoad]; 

self . view . backgroundColor = [[UlColor alloc] 

initWithPatternlmage : [UI Image imageNamed :@" gyro.jpg"]] ; 
UI Accelerometer *testAccel = [UIAccelerometer 
sharedAccelerometer ] ; 
test Accel . delegate = self; 
test Accel . updatelnterval = 0 . If ; 
temporisation = 0; 

[mouvement setText : ©"Le device est calme"]; 
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ACCÉLÉROMÈTRE 


- (void) viewDidUnload 

{ 

[self setX : nil] ; 

[self setY : nil] ; 

[self setZ : nil] ; 

[self setMouvement : nil] ; 

[super viewDidUnload]; 

// Release any retained subviews of the main view . 

// e.g. self . myOut let = nil; 

} 

- (void) accelerometer : (UIAccelerometer *) accelerometer 

didAccelerate : ( UI Accélérât ion *) accélération 

{ 

if ( f absf ( acce lerat ion . x) > 1.5 II f absf ( accélérât ion . y ) > 1. 
5 II fabsf (acceleration.z) > 1.5) 

{ 

[mouvement setText : @ " J 1 ai détecté une secousse"]; 
if (temporisation == 0) 
temporisation = 1; 

} 

x . t ext = [NS St r ing s t r ingWi thFormat : @ " '/,<§ '/,f",@"X =", 
accélération . x] ; 

y . t ext = [NS St ring s tr ingWi thFormat */,<§ '/,f",@"Y =", 

accélération . y] ; 

z . t ext = [NS St ring s tr ingWi thFormat */,@ '/,f",0"Z =", 

acceleration.z] ; 

if (temporisation > 0) 
temporisation++; 
if (temporisation == 30) 

{ 

[mouvement setText : ®"Le device est calme"]; 
temporisation = 0; 

} 


- (void) viewWill Appear : (B00L) animated 

{ 

[super viewWillAppear : animated] ; 

} 

- (void) viewDidAppear : (B00L) animated 

{ 

[super viewDidAppear : animated] ; 


} 
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- (void)viewWillDisappear:(BOOL) an i mat ed 

{ 

[super viewWillDisappear : animated] ; 

} 

- (void) viewDidDisappear : (B00L) animated 

{ 

[super viewDidDisappear : animated] ; 

} 

- (B00L) shouldAutorotateToInterfaceûrientation : ( 

UI Interface Orientât ion) interface Orientât ion 

{ 

// Return YES for supported orientations 
return ( inter f aceOrientat ion != 

UIInterfaceOrientationPortraitUpsideDown) ; 

} 

®end 


En résumé 

- Les accélérations détectées par l’accéléromètre consistent en trois valeurs flottantes 
qui représentent les trois axes du device. Pour obtenir ces informations, vous utiliserez 
la classe UIAccelerometer. 

- Définissez un objet de classe UIAccelerometer, définissez la période de mise à 
jour des informations le concernant avec la propriété update Int erval et utilisez 
la méthode didAccelerate pour obtenir les valeurs instantanées de l’accélération 
(accélération. x, accélération. y et accélération. z). 

- Pour détecter une secousse sur le device, il suffit que l’une des composantes d’accélé- 
ration renvoyées par l’objet accélération soit supérieure à une valeur donnée (1,5 
par exemple). 
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Chapitre 



Un jeu de casse-briques 


Difficulté : — 

D ans ce chapitre, vous allez apprendre à créer un jeu de casse-briques. Ce classique 
du genre va vous montrer de nombreuses techniques propres aux jeux et ainsi vous 
préparer pour le prochain chapitre, qui sera un TP sur la création d'un autre jeu. 
Mais revenons à ce chapitre. 

Vous apprendrez entre autres à : 

- définir et animer des objets animés; 

- détecter des collisions ; 

- effectuer des boucles de traitement ; 

- utiliser une musique de fond ; 

- utiliser des bruitages. 

J'espère vous avoir mis l'eau à la bouche. Passez vite à la suite et commençons sans 
attendre ! 
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Avant toute chose, je vais vous montrer à quoi va ressembler l’application que nous 
allons réaliser. Pour cela, regardez la figure 21.1. J’espère qu’elle vous plaît. 



Figure 21.1 - Le casse-briques que nous allons réaliser 


Définition de l’interface 


Lancez Xcode, définissez un nouveau projet de type Single View Application et 
donnez-lui le nom « pong » 1 . 

Ce jeu va utiliser plusieurs éléments graphiques : 

- une image d’arrière-plan de 320 x 480 pixels ; 

- une image PNG d’une brique de 70 x 15 pixels ; 

- une image PNG d’une raquette de 70 x 15 pixels ; 

- une image PNG d’une balle de 16 x 16 pixels. 


L’arrière-plan est une quelconque image enregistrée au format JPG ou PNG et de 
dimensions bien précises : 320 x 480 pixels. Les briques, la raquette et la balle sont au 
format PNG. Vous pouvez créer vous-mêmes vos images, mais au cas où, vous pouvez 
télécharger celles que j’ai utilisées dans ce chapitre. 


> 


Télécharger les images 
JJode web : 233945 


1. C’est moins long que « casse-briques » mais tout aussi parlant pour notre application. 
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Pour accéder facilement à ces éléments graphiques, vous allez les placer dans les res- 
sources de l’application. Cliquez du bouton droit sur la première icône du volet de 
navigation et sélectionnez New group dans le menu contextuel. Renommez le nou- 
veau dossier « Resources » . Maintenez le bouton gauche de la souris enfoncé et glissez- 
déposez les fichiers background . png, brique, png, raquette .png et balle, png de- 
puis le Finder dans le dossier Resources de l’application. Au relâchement du bouton 
gauche de la souris, une boîte de dialogue est affichée. Assurez-vous que la case Copy 
items into destination group’ s folder (if needed) est cochée, puis cliquez sur 
Finish. Votre arborescence devrait ressembler à la figure 21.2. 


I T PO"9 

L-J 1 target. iOS SDK 5.0 


▼ W Resources 


[«] background. png 
« balle. png 
« brique. png 
« raquette. png 

T [ ; pong 

h AppDelegate.h 
m AppDelegate.m 
[v] MainStoryboard.storyboard 
!h! ViewController.h 
[m] ViewController.m 
► (^jSupporting Files 

► Ù Frameworks 

► Q] Products 


Figure 21.2 - L’arborescence de votre application devrait ressembler à celle-ci 

Vous allez maintenant créer l’interface du jeu avec Interface Builder. 

Cliquez sur MainStoryboard.storyboard dans le volet de navigation et affichez si 
nécessaire le volet des utilitaires en cliquant sur l’icône Hide or Show the Utilities 
dans la barre d’outils. Vous allez maintenant déposer neuf contrôles UlImageView (oui, 
vous avez bien lu!) depuis la bibliothèque d’objets sur la vue de l’application. 

À quoi vont servir tous ces objets? Est-ce qu'ils sont vraiment tous néces- 
saires ? 

Eh bien oui, tous ces objets sont nécessaires : sept vont représenter les briques, un la 
raquette et le dernier la balle. 

Je vais vous montrer comment procéder pour un de ces objets, une brique en l’occur- 
rence. En utilisant la même technique, vous n’aurez aucun mal à définir et positionner 
les autres objets. Pour ajouter une brique, suivez les étapes ci-après. 

1. Glissez-déposez un contrôle UlImageView sur la feuille de l’application. 

2. Cliquez sur l’icône Show the Attributes inspector dans le volet des utilitaires. 
Déroulez la liste Image et choisissez « brique. png ». 

3. Cliquez sur l’icône Show the Size inspector et modifiez les dimensions de la 
brique : « 70 » dans la case Width et « 15 » dans la case Height (c’est la taille de 
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notre brique), comme indiqué à la figure 21.3. 

4. Déplacez la brique dans la partie supérieure de la vue. 



Figure 21.3 - Modifiez la taille de la brique 


Ajoutez puis déplacez les huit objets restant pour obtenir quelque chose ressemblant à 
la figure 21.4. 



View Controller 


Figure 21.4 - Disposez les briques comme ceci 



Dans votre code, n'oubliez pas de donner aux images les dimensions 
quates : 70 x 15 pixels pour la raquette et les briques et 16 x 16 pixels 
la balle. 


adé- 

pour 
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Pour en terminer avec l’interface de l’application, vous allez ajouter un contrôle Label. 
Ce contrôle sera utilisé pour afficher des informations textuelles du type « 3, 2, 1, 
partez. . . » lorsque le joueur perdra la balle. 

Glissez-déposez un contrôle Label de la bibliothèque d’objets sur la vue. Redimen- 
sionnez ce contrôle pour qu’il occupe les trois quarts de la vue. Dans l’inspecteur des 
attributs, supprimez le contenu de la case Text pour que le Label n’affiche rien par 
défaut et choisissez une police System de 50 points, comme à la figure 21.5. 



Figure 21.5 - Placez et paramétrez un Label 


Liaison des contrôles au code 

Pour pouvoir interagir avec ces contrôles, vous devez créer des outlets. Contrôle-glissez- 
déposez tour à tour chacun des objets de la vue sur le fichier d’en-têtes et créez les 
outlets briquel à brique7, balle, raquette et stop3s (pour le contrôle Label). Une 
fois tous les outlets créés, le fichier d’en-tétes devrait ressembler à ceci : 


1 

o 

# import CUIKit/UIKit .h> 




Z 

3 

A 

Sinterf ace 

ViewCont r oller : 

UlViewController 


4 

5 

@pr opert y 

(weak , 

nonat omi c ) 

IBOutlet 

UI Image View 

♦briquel ; 

6 

@pr opert y 

(weak , 

nonat omi c ) 

IBOutlet 

UI Image View 

♦brique2 ; 

7 

@pr opert y 

(weak , 

nonat omi c ) 

IBOutlet 

UI Image View 

♦brique3 ; 

8 

@pr opert y 

(weak , 

nonat omi c ) 

IBOutlet 

UI Image View 

♦brique4 ; 

9 

@pr opert y 

(weak , 

nonat omi c ) 

IBOutlet 

UI Image View 

♦brique5 ; 

10 

@pr opert y 

(weak , 

nonat omi c ) 

IBOutlet 

UI Image View 

♦brique6 ; 

11 

@pr opert y 

(weak , 

nonat omi c ) 

IBOutlet 

UI Image View 

♦ br ique7 ; 

12 

@pr opert y 

(weak , 

nonat omi c ) 

IBOutlet 

UILabel *stop3s; 

13 

@pr opert y 

(weak , 

nonat omi c ) 

IBOutlet 

UI Image View 

♦ balle ; 

14 

15 

@pr opert y 
@end 

(weak , 

nonat omi c ) 

IBOutlet 

UI Image View 

♦raquette 
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Immersion dans le code 

Définition de l’arrière-plan de l’application 

Vous allez maintenant commencer à écrire le code de l’application. La première étape va 
consister à définir l’image d’arrière-plan. Cliquez sur ViewController .m dans le volet 
de navigation et insérez l’instruction suivante au début de la méthode viewDidLoad : 

1 self . view . backgroundColor = [[UlColor alloc] 

init Wit hPat t ernlmage : [UI Image imageNamed : @ " backgr ound . png " 

]] ; 

Cette instruction a déjà été rencontrée à plusieurs reprises. Elle affecte une image 
d’arrière-plan (méthode backgroundColor) à la vue courante (self .view) en utilisant 
une image dans les ressources ([[UlColor alloc] initWithPatternlmage : [Ullmage 
imageNamed: ). L’image utilisée a pour nom « background.png ». Libre à vous d’utiliser 
une quelconque autre image, pourvu que sa taille soit égale à 320 x 480 pixels. 

Vous pouvez lancer l’application. Vous l’avez bien mérité. La figure 21.6 représente ce 
que vous devriez obtenir. 



Figure 21.6 - Les images de l’application s’affichent correctement 



N'essayez pas de jouer : nous n'avons pas encore écrit le code pour ça. 
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Déplacement de la balle 

Avant de pouvoir jouer, plusieurs étapes sont nécessaires. Dans un premier temps, 
vous allez donner vie à la balle. Pour cela, vous allez devoir mettre en place un ti- 
mer. Mais avant, retournez dans le fichier d’en-têtes et définissez la variable d’instance 
vitesseBalle comme suit : 

1 ©interface ViewCont r oller : UlViewController 

2 { 

3 CGPoint vitesseBalle; 

4 } 

La variable vitesseBalle est une structure CGPoint. Elle consiste en deux flottants 
qui définissent des coordonnées. Dans notre cas, nous utiliserons cette variable pour 
calculer l’endroit où la balle doit être affichée. La figure 21.7 vous montre ce que dit la 
documentation Apple sur la structure CGPoint. 


BOO Organizer - Documentation ** 

I b a y 

Devices Repos.tor.es Project s Archives Documentation 

O ® CD | £! ^ iâ iOS 5.0 Ubrary L jGraphi.. ^2DDr7 CGGeo Data Types CGPoint 

fo" ^ CGBase.h 


CGPoint 

A structure that contains a point in a two-dimensional coordinate System. 

•truct CGPoint < 

CGPloat x; 

CGPloat y; 

>; 

typedcf struct CGPoint CGPoint; 

Fields 

x 

The x-coordinate of the point. 

y 

The y-coordinate of the point. 

Availability 

Available in iOS 2.0 and later. 

Declared In 

CGGeometry .h 

CGRect 

A structure that contains the location and dimensions of a rectangle. 

struct CGRect { 

CGPoint origin; 

CGSize size; 

}; 

typedef struct CGRect CGRect; 

Fields 


Figure 21.7 - La documentation Apple concernant CGPoint 

Retournez dans le fichier ViewController . m et définissez la méthode boucleJeu comme 
suit : 


1 

2 


-(void) boucleJeu 

{ 
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3 balle . center = CGPointMake (balle . center . x + vitesseBalle . x , 

balle . center . y + vitesseBalle . y) ; 

4 if (balle. center. x > self. view. bounds .size.width | | balle. 

center . x < 0 ) 

5 vitesseBalle . x = -vitesseBalle .x; 

6 if (balle . center . y > self . view . bounds . size . height II balle. 

center .y < 0 ) 

7 vitesseBalle . y = -vitesseBalle .y; 

8 } 

Examinons les instructions utilisées dans cette méthode. 

La ligne 3 calcule les prochaines coordonnées de la balle (balle . center). Ces co- 
ordonnées sont obtenues en ajoutant aux coordonnées actuelles (balle . center . x et 
balle . center . y) le déplacement désiré (vitesseBalle .x et vitesseBalle . y). Tout 
ce petit monde est passé à une instruction CGPointMake, qui retourne les nouvelles 
coordonnées de la balle (CHPointMake ( . . .)). Pour que la balle se déplace, il suffit 
d’affecter le résultat de l’instruction CGPointMake à la propriété center de l’objet 
balle, c’est-à-dire au centre de la balle : 

1 balle . center = CGPointMake (balle . center . x + vitesseBalle . x , 
balle . center . y + vitesseBalle . y) ; 

L’instruction suivante s’intéresse à l’abscisse (la position horizontale) de la balle qui, 
rappelons-le, vient d’être calculée. Si cette abscisse est supérieure à la largeur de la 
vue (balle . center .x > self .view, bounds . size . width) ou si elle est négative (I I 
balle . center . x < 0), il suffit d’inverser la direction en X de la balle pour qu’elle ne 
sorte pas de la vue (vitesseBalle .x = -vitesseBalle . x; ). Ce qui donne : 

1 if (balle . center . x > self . view . bounds . size . width II balle. 

center . x < 0 ) 

2 vitesseBalle . x = -vitesseBalle .x; 

Examinez l’instruction suivante. Je suis sûr que vous y voyez quelques similitudes : 

1 if (balle . center . y > self . view . bounds . size . height II balle. 

center .y < 0 ) 

2 vitesseBalle . y = -vitesseBalle .y; 

Ici, c’est l’ordonnée (la position verticale) qui est examinée. Si elle dépasse la hauteur de 
la vue (balle . center .y > self .view, bounds . size .height) ou si elle est négative 
(I I balle . center .y < 0), la direction en Y est inversée pour que la balle ne sorte 
pas de la vue (vitesseBalle . y = -vitesseBalle . y). 

Tout cela est bien joli, mais dans quel sens va partir la balle? Je crois bien 
que la direction de la balle n'a pas été définie au lancement de l'application. 

Effectivement. Nous allons immédiatement réparer cette lacune en ajoutant l’instruc- 
tion suivante dans la méthode viewDidLoad : 
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l| vitesseBalle = CGPointMake ( 10 , 1 5 ) ; 

Cette instruction définit l’objet CGPoint vitesseBalle et affecte les valeurs 10 et 15 
à ses composantes X et Y. Par la suite, nous utiliserons cet objet pour modifier les 
coordonnées de la balle. . . et donc la déplacer. 

Je vous sens impatients de lancer l’application pour voir la balle se déplacer dans la 
vue. Je ne vais pas vous priver de ce plaisir. Cliquez sur Run et admirez. . . admirez. . . 
cette belle balle immobile au milieu de la vue ! 

Que se passe-t-il? J'ai pourtant respecté à la lettre tout ce qui a été dit 
jusqu'ici ! 

Réfléchissez un peu. Vous avez défini une méthode pour animer la balle, mais croyez- 
vous que cette méthode va s’exécuter toute seule? Bien sûr que non, il faut le lui 
demander en mettant en place un timer. Ajoutez l’instruction suivante dans la méthode 
viewDidLoad : 

1 timerl = [NSTimer s cheduledTimerWi thTimelnt erval : 0 . 05 target : 

self selector : Sselector (boucle Jeu) userlnfo :nil repeats:YES 

] ; 

Cette instruction définit l’objet timerl (timerl =) en utilisant un message Objective- 
C. Le message dit en substance ceci : 

- le code du timer doit être exécuté toutes les 0,05 seconde, soit 20 fois par seconde : 
[NSTimer scheduledTimerWithTimelnterval : 0 . 05 ; 

- la méthode à exécuter se trouve dans la classe courante, c’est-à-dire celle du contrô- 
leur de vue : target : self ; 

- la méthode à exécuter a pour nom boucleJeu : selector : Oselector (boucleJeu) ; 

- aucune information complémentaire n’est passée à cette méthode : userlnfo : nil ; 

- la méthode doit se répéter indéfiniment (ou du moins jusqu’à ce qu’il soit désactivé) : 
repeats : YES] . 

Pensez également à déclarer l’objet timer dans le fichier ViewController .h : 

1 ^interface ViewController : UlViewController 

2 { 

3 CGPoint vitesseBalle; 

4 NSTimer ♦timerl; 

5 } 

Maintenant, vous pouvez lancer l’application et voir (oh merveille !) la balle se déplacer 
et rebondir sur les coins de l’écran (et votre doigt sur le device). 



Déplacement de la raquette 

Vous allez maintenant donner vie à la raquette et lui demander de suivre la souris dans 
le simulateur. 
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Définissez la méthode suivante dans le fichier ViewController .m (par exemple, juste 
après la méthode boucleJeu) : 

1 -(void) t ouchesMo ved : ( NSSet ♦) touches withEvent : ( UIEvent *) 

e vent 

2 { 

3 UITouch *touch = [[event allTouches] anyObject]; 

4 CGPoint location = [touch locationlnView : touch . view] ; 

5 raquette . center = CGPointHake (location .x, raquette . center . y) ; 

6 } 

Examinons les instructions contenues dans cette méthode. À la ligne 3, l’objet touch 
de classe UITouch est défini (UITouch *touch). Il est initialisé avec toutes les actions 
toucher de l’utilisateur (= [[event allTouches] anyObject];): 

l| UITouch ♦touch = [[event allTouches] anyObject]; 

La ligne 4 définit l’objet location de classe CGPoint (CGPoint location) et l’initialise 
avec la position du toucher (= [touch locationlnView: touch. view] ;) : 

l| CGPoint location = [touch locationlnView : touch . view] ; 

La variable location contient la position du doigt de l’utilisateur dans la vue. L’instruc- 
tion de la ligne 5 affecte l’abscisse de cette position à celle de la raquette (raquette . center 
= CGPointMake(location.x, . . .). L’ordonnée de la raquette, quant à elle, ne doit pas 
suivre le doigt de l’utilisateur, mais rester sur une ligne horizontale (raquette . center . y) : 

l| raquette . center = CGPointMake ( location . x , raquette . center . y) ; 

Lancez l’application en cliquant sur Run. La raquette doit maintenant suivre les mou- 
vements de la souris, bouton gauche enfoncé. Quelle réussite! 

Lisez vite la suite, vous allez découvrir comment détecter des collisions entre deux 
objets. Cela vous permettra de faire rebondir la balle sur la raquette et d’effacer les 
briques sur lesquelles rebondit la balle. 

Détection des collisions 

Comme nous l’avons vu précédemment, il est possible de connaître les coordonnées 
d’un objet en utilisant les propriétés center. x et center. y de cet objet. Par exemple, 
les coordonnées de la balle sont obtenues avec les expressions balle . center . x et 
balle . center . y. 

Est-ce que vous savez comment détecter la collision entre deux objets? En testant 
leurs coordonnées center .x et center .y bien entendu ! Encore plus fort : vous pouvez 
utiliser la méthode CGRectlntersectsRect pour tester la collision entre deux objets. 

Voyons comment tester le contact de la balle sur la première brique. Ajoutez le test 
suivant dans la méthode boucleJeu : 

1 if (( CGRectlntersectsRect (balle . f rame , briquel . f rame ) ) && ( 

brique 1 . hidden == NO)) 
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2 { 

3 briquel . hidden=YES ; 

4 vitesseBalle . y = - vitesseBalle . y ; 

5 } 


La première ligne teste la collision (CGRectlntersectsRect) entre la balle (balle . f rame) 
et la première brique (briquel . frame), dans le cas où cette brique est toujours affichée 
(briquel .hidden == NO) : 

1 if (( CGRectlntersectsRect (balle . frame , briquel . frame ) ) && ( 

briquel . hidden == NO)) 


La troisième ligne cache la première brique : 

1 | briquel .hidden = YES; 

Quant à la quatrième ligne, elle inverse le sens de progression vertical de la balle : 

il vitesseBalle . y = -vitesseBalle . y ; 


La brique 1 n’est pas la seule présente dans la vue. Vous devez donc écrire un code 
équivalent pour les briques 2 à 7 : 


î 

2 

3 

4 

5 

6 

7 

8 
9 

10 

11 

12 

13 

14 

15 

16 

17 

18 

19 

20 
21 


if ((CGRectlntersectsRect (balle . frame ,brique2 . frame) ) && ( 

brique2 . hidden == NO)) 

{ 

brique2 . hidden=YES ; 

vitesseBalle . y = -vitesseBalle . y ; 

} 

if ((CGRectlntersectsRect (balle . frame ,brique3 . frame) ) && ( 

brique3 . hidden == NO)) 

{ 

brique3 . hidden=YES ; 

vitesseBalle . y = -vitesseBalle . y ; 

} 

if ((CGRectlntersectsRect (balle . frame ,brique4 . frame) ) && ( 

brique4 . hidden == NO)) 

{ 

brique4 . hidden=YES ; 

vitesseBalle . y = -vitesseBalle . y ; 

} 

if ((CGRectlntersectsRect (balle . frame ,brique5 . frame) ) && ( 

brique5 . hidden == NO)) 

{ 

brique5 . hidden=YES ; 

vitesseBalle . y = -vitesseBalle . y ; 

} 

if ((CGRectlntersectsRect (balle . frame ,brique6 . frame) ) && ( 

brique6 . hidden == NO)) 

{ 


22 

23 

24 


brique6 . hidden=YES ; 

vitesseBalle . y = -vitesseBalle . y ; 
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25 

26 

27 

28 

29 

30 


if ((CGRectlntersectsRect (balle . f rame , brique 7 . f rame ) ) 
brique7 . hidden == NO)) 

{ 

brique7 . hidden=YES ; 

vitesseBalle . y = - vit es seBalle . y ; 


( 



Si vous voulez écrire un code plus condensé, vous pouvez remplacer ces sept 
blocs if par une boucle. Je n'ai pas choisi cette voie pour ne pas vous em- 
brouiller : il y a déjà tant de nouveautés dans ce chapitre ! 


Exécutez l’application. Sous vos yeux ébahis, les briques disparaissent les unes après 
les autres ! Il nous reste encore à détecter la collision entre la balle et la raquette et à 
réagir en conséquence. 

Ajoutez le test suivant dans la méthode boucle Jeu : 

1 If (CGRectlntersectsRect (balle . frame , raquette . frame) ) 

2 { 

3 if (balle . center . y < raquette . center . y) 

4 vitesseBalle . y = - vit es seBalle . y ; 

5 } 

La ligne 1 teste la collision entre la balle (balle . frame) et la raquette (raquette .frame) : 
1 | if (CGRectlntersectsRect (balle . f rame , raquette . frame ) ) 

La ligne 3 teste si la balle se trouve plus bas que la raquette : 

l| if (balle . center . y < raquette . center . y) 

Dans ce cas, il convient d’inverser le sens de progression verticale de la balle pour qu’elle 
ne sorte pas de la vue : 

l| vitesseBalle . y = - vit e s seBalle . y ; 

Pour l'instant, nous n'allons pas gérer la perte de la balle. Cela se fera un peu 
plus loin dans le tutoriel. 

Exécutez l’application. Ça y est, la balle rebondit sur la raquette. Bravo ! Il est temps 
de passer à l’étape suivante. 



Musique de fond et bruits événementiels 

Pour ajouter une musique de fond à l’application, vous utiliserez la technique étudiée 
dans la section « Jouer des éléments audio » du chapitre consacré au son. Reportez- 
vous à cette section pour avoir des renseignements détaillés sur sa mise en œuvre (page 
322). 
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Une musique de fond, c’est bien, mais ce serait vraiment mieux si la balle produisait 
un bruit de balle lorsqu’elle frappe sur la raquette ou sur une brique. Pour cela, vous 
allez devoir utiliser un objet SystemSoundID. 


> 


Télécharger le son 
^Code web : 990717 


Ajoutez un son au format CAF dans les ressources de l’application. Cliquez sur le 
fichier ViewController .h dans le volet de navigation et ajoutez l’instruction suivante 
dans la définition de l’interface : 


1 SystemSoundID bruit; 


Rendez-vous dans le fichier ViewController .m et ajoutez cette instruction dans la 
méthode viewDidLoad : 

1 AudioServicesCreateSystemSoundlD ( CFBundleC opyRes our ceURL ( 

CFBundleGetMainBundle () , CFSTR ( " pong " ) , CFSTR ( " caf " ) , NULL), 
ftbruit ) ; 


Cette instruction met en relation le fichier audio à jouer (« pong.caf » dans cet exemple) 
et un objet SystemSoundID qui sera utilisé pour jouer le son (bruit dans cet exemple). 

Maintenant, vous devez encore ajouter quelques instructions pour jouer le son « pong.caf » 
lorsque la balle entre en contact avec la raquette ou avec une brique. Repérez le test 
de collision entre la balle et la raquette dans la méthode boucle Jeu et complétez- le 
comme suit : 

1 if ( CGRe et Int er se et sRec t (balle . frame , raquette . frame) ) 

2 { 

3 if (balle . center . y < raquette . center . y) 

4 { 

5 vitesseBalle . y = - vitesseBalle . y ; 

6 AudioServicesPlaySystemSound (bruit ) ; 

7 } 

8 } 


La ligne 6 joue le son « bruit » via la méthode AudioServicesPlaySystemSound. 

Vous allez maintenant ajouter la même instruction dans les tests de collision entre la 
balle et chacune des briques. Voici par exemple à quoi doit ressembler le test de collision 
entre la balle et la brique 1 : 

1 if (( CGRectlntersectsRect (balle . frame , briquet . frame ) ) && ( 

briquet . hidden == NO)) 

2 { 

3 briquet . hidden=YES ; 

4 vitesseBalle . y = -vitesseBalle . y ; 

5 AudioServicesPlaySystemSound (bruit ) ; 

6 } 


Insérez cette même instruction dans les six autres tests de collision. 
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Perte de la balle 

Je ne sais pas si vous avez remarqué, mais ce jeu présente un (petit) défaut : si le 
joueur n’arrive pas à rattraper la balle avec la raquette, celle-ci rebondit sur la partie 
inférieure de l’écran. Que diriez-vous d’ajouter un traitement relatif à la perte de la 
balle? Par exemple. . . émettre un rire pour augmenter le stress du joueur. 

^Télécharger le son 

[ Code web : 718763 y 

Commencez par ajouter un son au format caf dans les ressources de l’application. Pour 
que ce son puisse être joué, vous devez définir un objet SystemSoundlD et le relier à ce 
son. Ajoutez l’instruction suivante dans la partie interface du fichier ViewController . h : 

1 | SystemSoundlD rire ; 

Vous allez maintenant agir sur le code. Cliquez sur ViewController .h dans le vo- 
let de navigation et ajoutez l’instruction suivante un peu avant la fin de la méthode 
viewDidLoad : 

1 AudioServicesCreateSystemSoundlD ( CFBundleCopyRes our ceURL ( 

CFBundleGetMainBundle () , CFSTR ( " rire " ) , CFSTR ( " caf " ) , NULL), 
ftrire ) ; 

Pour savoir si le joueur a laissé passer la balle, ajoutez le test suivant dans la méthode 
boucleJeu : 

1 if (balle . center . y > self . view . bounds . size . height ) 

2 { 

3 AudioSer vicesPlay Sy s t emSound ( r ire ) ; 

4 balle . center = CGPointMake ( 100 . Of , 100. Of ) ; 

5 } 

Si l’ordonnée de la balle (balle . center . y) est supérieure à la hauteur de la vue 
(self . view. bounds . size .height), les instructions comprises entre les accolades sont 
exécutées. 

L’instruction de la ligne 3 émet un son pour signifier la perte de la balle : 

1 | AudioSer vicesPlay Sy st emS ound ( rire ) ; 

Quant à l’instruction de la ligne 4, elle repositionne la balle pour poursuivre la partie : 
il balle . center = CGPointMake ( 100 . Of , 100. Of); 


La touche finale 

Pour terminer cette application, nous allons afficher un message dans le Label lorsque 
toutes les briques ont été effacées et mettre fin à la boucle de jeu. Rendez-vous dans 
le fichier ViewController .m et ajoutez le bloc d’instructions suivant dans la méthode 
boucleJeu : 
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1 if (( brique 1 . hidden == YES) kk (brique2 . hidden == YES) kk ( 

brique3 . hidden == YES) kk ( brique4 . hidden == YES) kk ( 

brique5 . hidden == YES) kk ( brique6 . hidden == YES) kk ( 

brique7 . hidden == YES)) 

2 { 

3 stop3s . text = ©"Bravo !"; 

4 [timerl invalidate]; 

5 } 

Ça y est, l’application est entièrement fonctionnelle. Amusez-vous bien ! 



Si vous testez cette application dans le simulateur iOS 5.0, il se peut que vous 
obteniez une erreur à rallonge dans la console. Ne vous en faites pas : cette 
erreur n'en est pas vraiment une et l'application fonctionne à la perfection 
sur un iPhone, un iPod Touch ou un iPad sous iOS 5. Un correctif devrait 
être intégré dans les prochaines mises à jour de Xcode. Si cette erreur vous 
dérange vraiment, vous pouvez opter pour une solution alternative accessible 
grâce au code web suivant. 


Voir la solution alternative 
Code web : 510881 , 


Le code de l’application 

Le code de l’application se trouve dans le dossier pong. 


[Copier ce 

code 

N 

[Code web 

: 890053 

J 


ViewController .h 


1 

2 

3 

4 

5 

6 

7 

8 
9 

10 

11 

12 

13 

14 

15 


# import CUIKit/UIKit .h> 

# import < A VFoundat i on/ AVFoundat ion . h> 

# import <AudioToolbox/ AudioToolbox .h> 

©interface ViewController : UlViewController < 
AVAudioPlayerDelegate > 

{ 

CGPoint vitesseBalle ; 

NSTimer ♦timerl; 

AVAudioPlayer * audioPlayer; 

SystemSoundlD bruit; 

SystemSoundlD rire; 

} 

©property (weak , nonatomic) IBOutlet UlImageView tbriquel; 
©property (weak, nonatomic) IBOutlet UlImageView *brique2; 
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16 

@pr operty 

(weak , 

nonatomic ) 

IBOutlet 

UlImageView 

*brique3 ; 

17 

@pr operty 

(weak , 

nonatomic ) 

IBOutlet 

UlImageView 

*brique4 ; 

18 

@pr operty 

(weak , 

nonatomic ) 

IBOutlet 

UlImageView 

*brique5 ; 

19 

@pr operty 

(weak , 

nonatomic ) 

IBOutlet 

UlImageView 

♦ br ique6 ; 

20 

@pr operty 

(weak , 

nonatomic ) 

IBOutlet 

UlImageView 

* br ique7 ; 

21 

@pr operty 

(weak , 

nonatomic ) 

IBOutlet 

UILabel *stop3s; 

22 

@pr operty 

(weak , 

nonatomic ) 

IBOutlet 

UlImageView 

♦ balle ; 

23 

24 

@pr operty 
©end 

(weak , 

nonatomic ) 

IBOutlet 

UlImageView 

♦ raquette 


ViewController.m 


1 

2 

3 

4 

5 

6 

7 

8 
9 

10 

11 

12 

13 

14 

15 

16 

17 

18 

19 

20 
21 
22 

23 

24 

25 

26 


27 

28 


29 

30 

31 

32 


#import " Vi ewCont r o lier . h " 


©implémentation ViewController 
©synthesize briquel; 
©synthesize brique2 ; 
©synthesize brique3 ; 
©synthesize brique4; 
©synthesize brique5 ; 
©synthesize brique6 ; 
©synthesize brique7 ; 
©synthesize stop3s; 

©synthesize balle; 

©synthesize raquette; 


- ( void) didRecei veMemoryWarning 

{ 

[super didReceiveMemoryWarning] ; 

// Release any cached data, images , etc that aren ' t in use. 

} 


#pragma mark - View lifecycle 

- ( void) viewDidLoad 

{ 

[super viewDidLoad]; 

self . view . backgroundColor = [[UlColor alloc] 

init Wit hPat t ernlmage : [UI Image imageNamed :©" Californie . jpg’ 

]] ; 

vitesseBalle = CGPointMake ( 10 , 15 ) ; 

timerl = [NSTimer s cheduledTimerWi thTime Int erval : 0 . 05 target : 
self select or : ©select or ( bouc le Jeu ) userlnfo :nil repeats: 
YES ] ; 

UInt32 sessionCategory = kAudi oSes s ionCat egory _MediaP layback ; 

AudioSes s ionSe tPr opert y ( kAudio Ses s ionPr oper t y _ Audi oCat egory , 
sizeof (sessionCategory), & se s s i onCat egory ) ; 

NSData ♦soundFileData; 

s oundFileDat a = [NSData dat aWit hCont ent s Of URL : [MSURL 

f ileURLWithPath : [ [NSBundle mainBundle] pathForRe s our ce : © " 
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33 

34 

35 

36 

37 

38 

39 

40 

41 

42 

43 

44 

45 

46 

47 

48 

49 

50 

51 

52 

53 

54 

55 

56 

57 

58 

59 

60 

61 

62 

63 

64 

65 

66 

67 

68 

69 

70 

71 


LE CODE DE L’APPLICATION 


morceau. mp3 " of Type : NULL ]]] ; 
audioPlayer = [ [ AVAudioPlayer alloc] initWithData : 

soundFileData error:NULL]; 
audioPlayer . delegate = self; 

[audioPlayer setVolume : 1 . 0] ; 

[audioPlayer play]; 

AudioServicesCreateSystemSoundlD ( CFBundleC opyRes our ceURL ( 

CFBundleGetMainBundle () , CFSTR (" pong ") , CFSTR ( " caf " ) , NULL 
) , ftbruit ) ; 

AudioServicesCreateSystemSoundlD ( CFBundleC opyRes our ceURL ( 

CFBundleGetMainBundle () , CFSTR (" rire ") , CFSTR (" caf ") , NULL 
) , ftrire ) ; 


-(void) boucleJeu 

{ 

balle . center = CGPointMake (balle . center . x + vitesseBalle . x , 
balle . center . y + vitesseBalle . y) ; 
if (balle . center . x > self . view . bounds . size . width II balle, 
center . x < 0) 

vitesseBalle . x = -vitesseBalle . x ; 
if (balle . center . y > self . view . bounds . size . height II balle, 
center .y < 0) 

vitesseBalle . y = -vitesseBalle . y ; 

if (CGRectlntersectsRect (balle . f rame , raquette . f rame ) ) 

{ 

if (balle . center . y < raquette . center . y) 

{ 

vitesseBalle . y = -vitesseBalle . y ; 
AudioServicesPlaySystemSound (bruit ) ; 

} 

} 

if (balle . center . y > self . view . bounds . size . height ) 

{ 

AudioServicesPlaySystemSound ( rire ) ; 

balle . center = CGPointMake ( 100 . Of , 100. Of); 

} 

if ((CGRectlntersectsRect (balle . frame .briquel . frame) ) && ( 

briquel . hidden == N0)) 

{ 

briquel . hidden=YES ; 

vitesseBalle . y = -vitesseBalle . y ; 
AudioServicesPlaySystemSound (bruit ) ; 

} 

if ((CGRectlntersectsRect (balle . frame ,brique2 .frame) ) && ( 

brique2 . hidden == N0)) 

{ 
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80 
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brique2 . hidden=YES ; 

vitesseBalle . y = - vit es seBalle . y ; 
AudioServicesPlaySystemSound (bruit) ; 

} 

if (( CGRectlntersectsRect (balle . f rame , brique3 . f rame ) ) && ( 

brique3 . hidden == NO)) 

{ 

brique3 . hidden=YES ; 

vitesseBalle . y = - vit es seBalle . y ; 
AudioServicesPlaySystemSound (bruit) ; 

} 

if (( CGRectlntersectsRect (balle . f rame , brique4 . f rame ) ) && ( 

brique4 . hidden == N0)) 

{ 

brique4 . hidden=YES ; 

vitesseBalle . y = - vit es seBalle . y ; 
AudioServicesPlaySystemSound (bruit) ; 

} 

if (( CGRectlntersectsRect (balle . f rame , brique5 . f rame ) ) && ( 

brique5 . hidden == N0)) 

{ 

brique5 . hidden=YES ; 

vitesseBalle . y = - vit es seBalle . y ; 
AudioServicesPlaySystemSound (bruit) ; 

} 

if (( CGRectlntersectsRect (balle . f rame , brique6 . f rame ) ) && ( 

brique6 . hidden == N0)) 

{ 

briqueô . hidden=YES ; 

vitesseBalle . y = - vit es seBalle . y ; 
AudioServicesPlaySystemSound (bruit) ; 

} 

if (( CGRectlntersectsRect (balle . f rame , brique7 . f rame ) ) && ( 

brique7 . hidden == N0)) 

{ 

brique7 . hidden=YES ; 

vitesseBalle . y = - vit es seBalle . y ; 
AudioServicesPlaySystemSound (bruit) ; 

} 

if (( brique 1 . hidden == YES) && (brique2 . hidden == YES) && ( 
brique3 . hidden == YES) && ( brique4 . hidden == YES) && ( 

brique5 . hidden == YES) && ( brique6 . hidden == YES) && ( 

brique7 . hidden == YES)) 

{ 

stop3s . text = ®"Bravo !"; 

[timerl invalidate]; 


} 
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-(void) t ouchesMo ved : ( NSSet ♦) touches withEvent : ( UIE vent *) 
e vent 

{ 

UITouch *touch = [[event allTouches] anyObject]; 

CGPoint location = [touch locationlnView : touch . view] ; 
raquette . center = CGPointMake ( location . x , raquette . center . y) ; 

} 

- ( vo id ) viewDidUnload 

{ 

[self setBriquel : nil] ; 

[self setBrique2 : nil] ; 

[self setBrique3 : nil] ; 

[self setBrique4 : nil] ; 

[self setBrique5 : nil] ; 

[self setBrique6 : nil] ; 

[self setBrique7 : nil] ; 

[self setStop3s : nil] ; 

[self setBalle : nil] ; 

[self setRaquette : nil] ; 

[super viewDidUnload]; 

// Release any retained subviews of the main view . 

// e.g. self . myOutlet = nil; 

} 

- (void)viewWillAppear:(B00L) an i mat ed 

{ 

[super viewWillAppear : animated] ; 

} 

- (void) viewDidAppear : (B00L) animated 

{ 

[super viewDidAppear : animated] ; 

} 

- (void)viewWillDisappear:(B00L) animated 

{ 

[super viewWillDisappear : animated] ; 

} 

- (void) viewDidDisappear : (B00L) animated 

{ 

[super viewDidDisappear : animated] ; 

} 

- (B00L) shouldAutorotateToInterfaceûrientation : ( 

UI Interface Orientât ion) interface Orientât ion 

{ 

// Return YES for supported orientations 


405 


CHAPITRE 21. UN JEU DE CASSE-BRIQUES 


162 

163 

164 

165 


return ( int erf ace Or ient at ion ! = 

UIInterfaceOrientationPortraitUpsideDown) ; 

} 

Oend 


En résumé 

- Pour déplacer un objet sur l’écran, vous devez mettre en place un timer et modifier 
les coordonnées de l’objet dans la méthode activée à intervalle régulier par le timer. 

- Pour manipuler les coordonnées d’un objet, le plus simple consiste à utiliser des objets 
CGPoint, qui permettent de stocker deux valeurs flottantes (ici, les coordonnées X 
et Y de l’objet). 

- Pour contrôler les mouvements de toucher, définissez un objet UITouch, et spéci- 
fiez quelles actions de toucher doivent être capturées. La méthode locationlnView, 
appliquée à l’objet UITouch, donne les coordonnées X, Y du toucher. 

- Pour détecter la collision entre deux objets sur l’écran, il suffit de comparer les 
coordonnées X et Y de leurs centres respectifs. 
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Chapitre 



TP : Capturez les vers 


Difficulté : — 

Q ue diriez-vous d'écrire votre propre jeu? Dans ce TP, je vous propose de mettre 
en oeuvre les techniques étudiées dans cette partie (et aussi un peu dans les parties 
précédentes). Le but de votre mission, si vous l'acceptez, va consister à éradiquer une 
colonie de vers qui menace la santé d'un végétal sur lequel elle a élu domicile. 

Je vous sens enthousiastes, mais également soucieux des difficultés à venir. . . N'ayez 
crainte : si vous suivez les conseils que je vais vous donner, tout se passera à merveille. 
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Principe du TP 

Un aperçu de ce qui vous attend 

Dans ce TP, vous allez devoir : 

- afficher une image en arrière-plan du device ; 

- mettre en place un timer ; 

- afficher/faire disparaître de petits objets graphiques (aussi appelés « sprites ») ; 

- tester les éventuelles collisions ; 

- ajouter une musique d’arrière-plan ; 

- ajouter un bruitage sur les actions du joueur et sur la perte d’un point. 

Votre mission va consister à afficher des sprites sur l’écran pendant une durée aléatoire 
comprise entre 0,5 et 1,5 seconde, puis à les faire disparaître. Si le joueur touche un 
sprite avant qu’il ne disparaisse, il gagne un point. Dans le cas contraire, un son est 
joué pour lui signifier qu’il vient d’échouer. 

La figure 22.1 représente ce que vous devez obtenir (libre à vous de choisir un autre 
fond d’écran et un autre sprite) : 



Figure 22.1 - L’application « Capturez les vers » 
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Les ressources du projet 

Le projet utilisera les ressources suivantes : 

- une image JPG ou PNG de 320 x 480 pixels pour l’arrière-plan ; 

- une image PNG transparente de 60 x 60 pixels pour le sprite ; 

- un morceau MP3 pour l’arrière-plan sonore ; 

- un son CAF qui sera émis lorsque le joueur pointe un ver avec son doigt ; 

- un autre son CAF qui sera émis lors de la disparition d’un ver ou lorsque le joueur 
pointe l’arrière-plan et non le ver. 

Vous pouvez télécharger les ressources que j’ai utilisées pour vous faciliter la tâche, 
mais rien ne vous empêche de créer les vôtres. 

> 


Télécharger les ressources 
Code web : 451253 


Mise en place d’un timer 

Le timer du jeu de casse-briques est une bonne base de départ. Mais attention, il ne 
s’agit que d’une base de départ. N’oubliez pas que le sprite devra s’afficher pendant 
une durée variable comprise entre 0,5 et 1,5 seconde. D’autre part, un message de 
démarrage du type « Attention ...3...2...1... C’est à vous » devra s’afficher au 
début de la partie. Le délai entre les différentes parties du message sera fixé à 1 seconde, 
pour que le joueur ait le temps de lire ce qui est écrit. Etant donné qu’un seul timer 
sera utilisé pour rythmer ces différentes phases de jeu, il sera nécessaire de modifier 
son paramétrage pendant l’exécution du jeu. 


Affichage/disparition d’un sprite 

Le sprite sera affiché dans un contrôle Image View. Pour le faire disparaître/apparaître, 
vous utiliserez sa propriété alpha. Affectez la valeur 0 . Of à cette propriété pour faire 
disparaître le ver, et la valeur 1 . Of pour le faire apparaître. 



Je ne sais pas si vous vous rappelez du chapitre précédent, dans lequel les 
briques étaient cachées en agissant sur leur propriété hidden. Ici, je vous 
propose d'utiliser une variante qui produira le même effet. N'oubliez pas que 
la documentation de Xcode est une alliée de choix lorsque vous expérimentez 
une nouvelle technique. 


Tests de collisions 

Il vous suffit d’utiliser la méthode touche sBegan pour obtenir les coordonnées du 
toucher (une technique similaire, basée sur la méthode touchesMoved a déjà été étudiée 
dans le jeu de casse-briques). Comparez les coordonnées du toucher avec celles du sprite 
et vous saurez si le joueur a bien visé ou s’il a besoin de nouvelles lunettes ! 
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Je ne reviendrai pas sur les techniques à utiliser pour afficher une image 
en arrière-plan, jouer une musique de fond ou émettre des bruits lors des 
actions du joueur. Ces techniques doivent maintenant être acquises. Dans le 
cas contraire, revenez en arrière pour savoir comment les mettre en oeuvre. 

Je crois que je vous ai bien aidés et que vous êtes fin prêts à réaliser votre propre jeu. 
Amusez-vous bien ! 



Solution 


Que votre application fonctionne à la perfection ou que vous ayez buté sur un ou 
plusieurs points de détail, je vais vous montrer ma façon de voir les choses. 



Comme toujours en programmation, il n'y a pas une, mais plusieurs solutions. 
C'est pourquoi je parle de « ma façon de voir les choses ». Il se peut donc 
que vous ayez écrit un tout autre code pour parvenir au même résultat. 


Comme je vous l’ai suggéré dans la section « Principe du TP », le projet a été scindé en 
plusieurs étapes consécutives. Nous allons maintenant examiner chacune de ces étapes. 


Création du projet 

Définissez un nouveau projet de type Single View Application et donnez-lui le nom 
« ver » . Munissez- vous des ressources suivantes : 

- une image JPG ou PNG de 320 x 480 pixels pour l’arrière-plan ; 

- une image PNG transparente de 60 x 60 pixels pour le sprite ; 

- un morceau MP3 pour l’arrière-plan sonore ; 

- un son CAF qui sera émis lorsque le joueur pointe un ver avec son doigt ; 

- un autre son CAF qui sera émis lors de la disparition d’un ver ou lorsque le joueur 
pointe l’arrière-plan et non le ver. 

Pour stocker ces fichiers dans l’application, vous allez créer le dossier Resources. Cli- 
quez du bouton droit sur le dossier ver dans le volet de navigation et sélectionnez New 
Group dans le menu. Donnez le nom « Resources » à ce dossier et déplacez les cinq 
fichiers de ressource depuis le Finder dans le dossier Resources de l’application. La 
figure 22.2 représente le volet de navigation que vous devriez avoir. 

Ici, fondver.jpg est l’image d’arrière-plan du jeu, ver.png le sprite, morceau. mp3 la 
musique d’arrière-plan, pong.caf le bruit émis lorsque le joueur appuie sur un sprite 
et rire . caf le bruit qui est émis lorsqu’un sprite disparaît sans que le joueur ait cliqué 
dessus. 
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attaqueDesVers 

L-J i target. iOS SDK 5.0 

j attaqueDesVers 

* fondver.jpg 
« ver.png 

\]i] morceau. mp3 

* pong.caf 
■ rire.caf 

h] AppDelegate.h 
m AppDelegate.m 
g| MainStorYboard.storyboard 
jh] ViewController.h 
[m| ViewController.m 
► CZi Supportino Files 

► Frameworks 

► □ Products 


Figure 22.2 - Les ressources apparaissent dans l’arborescence du projet 



Comme vous pouvez le voir, le sprite est un fichier PNG. Ce format n'a pas 
été choisi au hasard. En effet, les images PNG peuvent contenir des pixels 
transparents, ainsi le sprite se superposera parfaitement sur l'image d'arrière- 
plan (figure 22.3). Vous pouvez utiliser une application graphique quelconque 
pour créer des images PNG à pixels transparents. Par exemple PaintBrush ou 
Gimp. 


Sprite au format PNG Sprite au format JPG 


Le sprite s'intégre parfaitement 
sur l'image d'arrière-plan 



transparents 


Mauvaise intégration du sprite 
sur l'image d'arrière-plan 



pas transparents 


Figure 22.3 - À gauche, le sprite contient des pixels transparents ; à droite, non 


Définition de l’écran de jeu 

L’écran de jeu est vraiment simple, il contiendra deux contrôles : 

- un Image View, pour afficher le ver; 

- un Label pour afficher le score. 
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Cliquez sur MainStoryboard. storyboard dans le volet de navigation et ajoutez un 
contrôle UlImageView ainsi qu’un contrôle Label au canevas. Définissez l’outlet leVer 
pour l’Image View et l’outlet leMessage pour le Label. 

Le fichier d’en-têtes doit maintenant ressembler à ceci : 

1 # import <UIKit/UIKit.h> 

2 

3 Sinterface ViewController : UlViewController 

4 

5 Sproperty (weak, nonatomic) IBOutlet UlImageView ♦leVer; 

6 Oproperty (weak, nonatomic) IBOutlet UILabel ♦leMessage; 

7 Oend 


Affichage d’une image en arrière-plan 

Cliquez sur ViewController .m dans le volet de navigation et insérez la ligne suivante 
dans la méthode viewDidLoad ; 

1 self . view . backgroundColor = [[UlColor alloc] 

init Wit hPat t ernlmage : [UI Image imageNamed :@"fondver.jpg"]] ; 

Cette technique a été utilisée et expliquée à maintes reprises dans les chapitres précé- 
dents, nous n’y reviendrons pas. 


Mise en place du timer 

Commencez par définir la variable d’instance timerl de classe NSTimer dans le fichier 
d’en-têtes : 

1 interface ViewController : UlViewController < 

AVAudioPlayerDelegate > 

2 { 

3 NSTimer ♦timerl; 

4 } 

Puis insérez la ligne suivante dans la méthode ViewDidLoad : 

1 timerl = [NSTimer s cheduledTimerWit hTime Int er val : 1 . Of target : 

self select or : Sselect or ( boucle Jeu ) userlnfo :nil repeats:YES 

1 ; 

scheduledTimerWithTimelnterval : 1 . Of met en place un timer exécuté toutes les se- 
condes. La méthode appelée a pour nom BoucleJeu (selector : Oselector (boucleJeu) ) 
Elle se répète indéfiniment, jusqu’à ce que l’application soit arrêtée par le joueur 
(repeats : YES). 

Vous vous doutez certainement de ce que sera l’étape suivante : la définition de la 
méthode boucleJeu. 

J’ai distingué trois étapes de jeu : 
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- une étape initiale, pendant laquelle un message indique au joueur que la partie va 
commencer ; 

- une deuxième étape pendant laquelle le sprite est affiché sur l’écran ; 

- une troisième étape pendant laquelle le sprite est dissimulé. 

Pour définir ces trois étapes, j’ai choisi d’utiliser une variable d’instance de classe int 
que j’ai appelée état. Cette variable est définie dans le fichier d’en-têtes : 

1 ©interface ViewCont r oller : UlViewController < 

AVAudioPlayerDelegate > 

2 { 

3 NSTimer *timerl; 

4 int état; // Etat du jeu 

5 } 


Voici la structure de la méthode boucle Jeu : 


1 

2 

3 

4 

5 

6 

7 

8 
9 

10 

11 

12 

13 

14 

15 


-(void) boucleJeu 

{ 

swit ch ( état ) 

{ 

case 0 : 

// Décompte de départ 
break ; 
case 1 : 

// Affichage du ver 
break ; 
case 2 : 

// Disparition du ver 
break ; 

} 

} 


Il ne reste plus qu’à insérer des instructions à la suite des trois case pour donner vie 
à la boucle de jeu 


Case 0 

Au lancement de l’application, le jeu doit afficher un décompte. L’étape initiale corres- 
pond donc à état = 0. Définissez cette valeur dans la méthode viewDidLoad : 

1 - ( vo id ) viewDidLoad 

2 { 

3 [super viewDidLoad]; 

4 état = 0; 

5 timerl = [NSTimer s cheduledTimerWi thTimelnt erval : 1 . Of target : 

self selector : ©selector (boucle Jeu) userlnfo :nil repeats: 
YES ] ; 

6 } 
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Au début de la partie, un message du type « Attention ... 3 ... 2 ... 1 ... C’est à 
vous » doit s’afficher dans le Label. Chacune des parties de ce message, c’est-à-dire 
« Attention », « 3 », « 2 », « 1 » et « C’est à vous » est affichée pendant une seconde. 
Pour savoir où l’on se trouve dans le décompte, vous allez définir la variable d’instance 
compteur de classe int dans le fichier d’en-têtes : 

1 ©interface ViewController : UlViewController 

2 { 

3 NSTimer *timerl; 

4 int état; // État du jeu 

5 int compteur; // Compteur de départ de jeu 

6 } 

Puis vous allez initialiser cette variable à 4 dans la méthode viewDidLoad : 

1 - (void) viewDidLoad 

2 { 

3 [super viewDidLoad]; 

4 état = 0 ; 

5 compteur = 4; // Compteur au départ du jeu 

6 timerl = [HSTimer s cheduledTimerWi thTime Int erval : 1 . Of target : 

self select or : ©select or ( bouc le Jeu ) userlnfo :nil repeats: 
YES] ; 

7 } 


Maintenant, vous allez compléter la méthode boucleJeu pour afficher les messages 
dans le Label : 


1 

2 

3 

4 

5 

6 

7 

8 
9 

10 

11 

12 

13 

14 

15 

16 

17 

18 

19 

20 
21 
22 


-(void) boucleJeu 
{ 

swit ch ( et at ) 

{ 

case 2 : 

// Disparition du ver 
break ; 

case 1 : 

// Affichage du ver 
break ; 


case 0 : 

// Décompte de départ 

if (compteur == 4) 

{ 

[leMessage setText : @" Attention"] ; 
compteur - - ; 

} 

else if ((compteur >=1) && (compteur < = 3 ) ) 

{ 

leMessage . text = [NSString stringWithFormat : 


! " '/, i 
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23 

24 

25 

26 

27 

28 

29 

30 

31 

32 

33 


} 


} 


compteur - - ; 

> 

else if (compteur == 0) 

{ 

[leMessage setText : @ "C ' est à vous !"]; 
compteur = 4; 

état = 1; //Affichage d'un ver 

} 

break ; 


Examinons ces instructions. Au lancement du jeu, compteur vaut 4. Le test if (compteur 
== 4) étant vérifié, les instructions exécutées sont donc les suivantes : 

1 if (compteur == 4) 

2 { 

3 [leMessage setText : @ " Attent ion "] ; 

4 compteur--; 

5 } 


L’instruction de la ligne 3 affiche le message « Attention » dans le Label et l’instruction 
de la ligne 4 décrémente la variable compteur. La méthode boucleJeu se termine. Elle 
sera à nouveau exécutée dans une seconde puisque le rimer mis en place a une période 
de 1 seconde. 

À la deuxième exécution de la méthode boucleJeu, compteur vaut 3. C’est donc cette 
portion du code qui est exécutée : 

1 else if ((compteur >=1) && (compteur <=3)) 

2 { 

3 leMessage . text = [NSString stringWithFormat : @"‘/,i ...", 

compteur] ; 

4 compteur--; 

5 } 


L’instruction de la ligne 3 affiche la valeur du compteur dans le Label : 3. La propriété 
text du Label étant de type NSString, il est nécessaire d’effectuer une conversion int 
-> NSString. C’est la raison d’être du message de la ligne 3. 

La ligne 4 décrémente la variable compteur qui vaudra 2 lors du prochain passage dans 
la méthode boucleJeu. 

Vous l’aurez compris, la même portion de code est exécutée lorsque compteur vaut 2, 
puis vaut 1. Une fois les messages « 2 » puis « 1 » affichés dans le Label, compteur 
vaut 0. C’est donc la dernière partie du code qui est exécutée : 

1 else if (compteur == 0) 

2 { 

3 [leMessage setText : @ "C ' est à vous !"]; 

4 compteur = 4; 

5 état = 1; //Affichage d'un ver 

6 } 
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Dans ce cas, la ligne 3 affiche « C’est à vous » dans le Label, la ligne 4 initialise le 
compteur à 4 et la ligne 5 affecte la valeur 1 à la variable état, ce qui signifie que 
la portion de code qui suit le case 1 sera exécutée lors du prochain passage dans la 
méthode boucleJeu. 


Case 1 


Lorsque état vaut 1, l’application doit afficher un ver sur l’écran pendant une durée 
aléatoire comprise entre 1 et 3 secondes. Pour accomplir cette étape, vous aurez besoin 
de nouvelles variables. Complétez le fichier d’en-têtes comme suit : 


1 

^interface ViewController : UlViewController 

2 

{ 




3 

NSTimer ♦timerl 




4 

int état ; 

// 

État du 

jeu 

5 

int compteur ; 

// 

Compteur 

de départ de jeu 

6 

f loat leTemps ; 

// 

Durée de 

1 'état actuel 

7 

int largeur ; 

// 

Largeur 

de 1 ' écran 

8 

int hauteur ; 

// 

Hauteur 

de 1 ' écran 

9 

f loat posX ; 

// 

Position 

en X du ver 

10 

f loat posY ; 

// 

Position 

en Y du ver 

11 

} 





La variable leTemps sera utilisée pour stocker la durée de l’affichage du sprite. 

Les variables largeur et hauteur contiendront la largeur et la hauteur en pixels du 
device. Ces valeurs sont importantes, car tous les devices n’ont pas la même définition. 

Enfin, les variables posX et posY seront utilisées pour mémoriser la position du sprite 
sur l’écran. 


Complétez le code situé entre les instructions case 1: et break; comme suit : 


î 

2 

3 

4 

5 

6 

7 

8 
9 


10 

11 


// Affichage du ver 

posX = (arc4random() '/, (largeur - 60)) + 30; 
posY = ( ar c4random ( ) / (hauteur - 60)) + 30; 
leVer . center = CGPointMake (posX , posY); 
leVer . alpha = 1 . Of ; 

leTemps = ( arc4random ( ) */, 3) + 1; //Nombre aléatoire entre 1 

et 3 

[timerl invalidate]; 

timerl = [NSTimer s cheduledTimerWi thTime Int erval : leTemps 
target : self selector : Oselector (boucle Jeu) userlnfo :nil 
repeat s : YES ] ; 
état = 2 ; 
break ; 


La ligne 3 calcule la position en X du sprite. Pour cela, nous utilisons la fonction 
Objective-C arc4random, qui renvoie un nombre entier compris entre 0 et 4 294 967 
295. La valeur renvoyée étant bien supérieure à la taille des écrans des iPhones (tant 
horizontalement que verticalement), il est nécessaire de la réduire. 
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La variable largeur représente la largeur en pixels de l’écran. Étant donné que le 
sprite est un carré de 60 x 60 pixels et que la fonction qui l’affiche sur l’écran se base 
sur son centre, il est nécessaire de restreindre les nombres tirés aléatoirement entre 30 
et largeur - 30. La première partie du calcul (arc4random() “/, (largeur - 60)) 
renvoie un nombre compris entre 0 et largeur - 60. En lui ajoutant la valeur 30, on 
obtient la plage souhaitée : 30 à largeur - 30. 

La ligne 4 utilise un calcul similaire pour obtenir un nombre aléatoire compris entre 30 
et hauteur - 30 : 

l| posY = ( ar c4r andom ( ) / (hauteur - 60)) + 30; 

La ligne 5 affiche le ver sur l’écran aux coordonnées posX, posY calculées précédem- 
ment : 

l| leVer . center = CGPointMake (posX , posY); 

La ligne 6 affecte la valeur 1 . Of à la propriété alpha du sprite pour le faire apparaître 
sur l’écran : 

l| leVer. alpha = 1 . Of ; 

La ligne 7 mémorise dans la variable leTemps un nombre entier aléatoire compris entre 
1 et 3. Ce nombre va correspondre au temps d’affichage du sprite. Libre à vous de le 
modifier comme bon vous semble. 

l| leTemps = ( ar c4random ( ) '/, 3) + 1; 

La ligne 8 désactive le timer actuel : 

1 | [timerl invalidate] ; 

Quant à la ligne 9, elle définit le nouveau timer basé sur la durée aléatoire calculée 
ligne 7 : 

1 timerl = [NSTimer s cheduledTimerWi thTimelnterval : leTemps target 
: self selector : Oselector (boucle Jeu) userlnfo :nil repeats:YES 
] ; 

Enfin, la ligne 10 indique que le jeu a changé d’état. Lors de la prochaine exécution 
de la méthode boucleJeu, ce sont les instructions qui suivent le case 2: qui seront 
exécutées : 

1 | état = 2 ; 

Ah oui, j’allais oublier. Les variables largeur et hauteur n’ont pas été initialisées. 
Ajoutez les deux lignes suivantes dans la méthode viewDidLoad pour réparer cette 
lacune : 

1 largeur = self . view . bounds . size . width ; // Largeur de l'écran 

2 hauteur = self . view . bounds . size . height ; // Hauteur de l'écran 
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Case 2 


Lorsque état vaut 2, l’application doit faire disparaître le ver qui est affiché. La durée 
de la disparition (c’est-à-dire le temps pendant lequel aucun ver n’est affiché sur l’écran) 
est très brève : 1/2 seconde. L’application doit également tester si le joueur a touché le 
ver avant qu’il ne disparaisse et, dans le cas contraire, émettre un son. Pour accomplir 
cette étape, vous aurez besoin d’une nouvelle variable pour savoir si l’écran a été touché 
par le joueur. J’ai choisi d’appeler cette variable aTouche. Définissez-la dans le fichier 
d’en-têtes. Tant que vous y êtes, définissez les variables réussi et rate pour tenir le 
compte des vers capturés et des vers ratés : 

1 int aTouche; // 1 si le joueur a touché l'écran, 0 sinon 

2 int réussi; // Nombre de vers capturés 

3 int rate; // Nombre de vers ratés 


Ces trois variables étant définies, retournez dans le code et complétez les instructions 
entre case 2: et break; comme suit : 


1 

2 

3 

4 

5 

6 

7 

8 
9 

10 

11 

12 

13 


14 

15 


case 2 : 

// Disparition du ver 
if (aTouche == 0) 

{ 

rate++; // Sinon, le joueur n'a pas eu le temps de toucher 
l'écran, donc le ver est raté 

leMessage . text = [NSString stringWithFormat: ©"Vers attrapé 
s '/,i ratés ’/.i ", réussi , rate]; 
AudioServicesPlaySystemSound (rire) ; 

} 

leVer . alpha = 0 . Of ; 
le Temps = 0 . 5f ; 

[timerl invalidate]; 

timerl = [NSTimer s cheduledTimerWi thTime Int erval : leTemps 
target : self selector : ©selector (boucle Jeu) userlnfo :nil 
repeat s : YES ] ; 
état = 1 ; 
break ; 


Examinons ces instructions. Par convention, aTouche vaut 0 si l’écran n’a pas été 
touché par le joueur. Il vaut 1 dans le cas contraire. La ligne 3 teste si l’écran n’a pas 
été touché. Dans ce cas, cela signifie que le joueur n’a pas eu le temps de capturer le 
ver. Le nombre de vers ratés est donc incrémenté de 1 : 

1 | rate ++ ; 

Puis le Label est mis à jour en conséquence : 

1 leMessage . text = [NSString stringWithFormat: ©"Vers attrapés ’/,i 
ratés */, i" , reus si , rate] ; 

Et enfin, un son est émis : 
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1 | Audio Servi cesPlaySy s temSound ( rire ) ; 

La ligne 10 fait disparaître le ver de l’écran : 

l| leVer. alpha = 0 . Of ; 

La ligne 11 fixe le temps de la disparition à 1/2 seconde : 

1 | leTemps = 0 . 5f ; 

Rappelez- vous, le ver doit disparaître pendant 1 /2 seconde. C’est la raison pour laquelle 
la ligne 12 désactive le timer actuel et la ligne 13 le remplace par un nouveau, basé sur 
une période de 1/2 seconde : 

1 [timerl invalidate]; 

2 timerl = [MSTimer s cheduledTimerWi thTimelnterval : leTemps target 

: self selector : Sselector (boucle Jeu) userlnfo :nil repeats:YES 

] ; 

Enfin, la ligne 14 fait passer le jeu dans l’étape 1. La prochaine exécution de la méthode 
boucleJeu provoquera donc l’affichage d’un nouveau sprite : 

1 | état = 1 ; 

J’espère que vous n’avez pas trop souffert en décortiquant la méthode boucleJeu. Il 
faut bien avouer qu’elle était un peu longue. Mais vous serez certainement d’accord 
avec moi, ces instructions n’avaient rien d’insurmontable. 

Pour souffler un peu, n’hésitez pas à lancer l’application. Vous verrez, elle fonctionne 
à la perfection en ce qui concerne la séquence de départ ainsi que l’affichage et la 
disparition des sprites. 

J’ai une bonne nouvelle pour vous : cette méthode était de loin la plus complexe de 
l’application. 

Tests de collisions 

Vous allez maintenant écrire un peu de code pour tester si la position pointée par 
le joueur correspond à celle du sprite. Pour cela, il vous suffit d’utiliser la méthode 
touche sBegan pour obtenir les coordonnées du toucher. Comparez ces coordonnées 
avec celles du sprite et vous saurez si le joueur a bien ou mal visé. 

Voici le code à mettre en place : 

1 -(void) t ouchesBegan : ( NSSet ♦) touches withEvent : ( UIE vent *) 

e vent 

2 { 

3 aTouche = 1; // Le joueur a touché l'écran 

4 UITouch *touch = [[event allTouches] anyObject]; 

5 CGPoint location = [touch locationlnView : touch . view] ; 

6 if (( abs ( location . x - posX)<30) && (abs ( location . y - posY)<30 

)) 
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7 

8 
9 

10 

11 

12 

13 

14 

15 

16 

17 

18 

19 

20 


21 

22 


{ 

reus s i ++ ; 

AudioServicesPlaySystemSound (bruit) ; 

} 

else 

{ 

AudioServicesPlaySystemSound (rire) ; 
rate ++ ; 

} 

leMessage . text = [NSString stringWithFormat : @"Vers attrapés 
'/, i ratés '/, i ", réussi , rate]; 

// Affichage d'un autre ver 

[timerl invalidate]; 

timerl = [HSTimer s cheduledTimerWi thTime Int erval : 0 . Of target : 
self select or : Oselect or ( bouc le Jeu ) userlnfo :nil repeats: 
YES] ; 
état = 2 ; 


À la ligne 3, la variable aTouche est initialisée à 1 pour indiquer que le joueur a touché 
l’écran. 

Les lignes 4 et 5 récupèrent les coordonnées du toucher. La technique utilisée ici a été 
décrite dans la section « Immersion dans le code » du jeu de casse-briques. Reportez- 
vous-y si nécessaire. 

La ligne 6 teste si le joueur a touché un sprite. Les entités location. x et location. y 
représentent les coordonnées du toucher. Quant à posX et posY, elles représentent le 
centre du sprite. 

Si : 


1. la différence entre l’abscisse du toucher et l’abscisse du centre du sprite est infé- 
rieure à 30 ((abs(location.x - posX)<30)); 

2. la différence entre l’ordonnée du toucher et l’ordonnée du centre du sprite est 
inférieure à 30 ((abs (location. y - post)<30)); 

cela signifie que le joueur a touché le sprite. Dans ce cas, le nombre de vers capturés 
est incrémenté de 1 (ligne 8) et un bruit de capture est émis (ligne 9). 

Si le joueur a touché l’écran en dehors du sprite, un rire est émis (ligne 13) et le nombre 
de vers ratés est incrémenté de 1 (ligne 14). 

Pour terminer, le timer actuel est désactivé (ligne 19), un nouveau timer à effet im- 
médiat (scheduledTimerWithTimelnterval initialisé à O.Of) est défini (ligne 20) et 
l’application bascule dans l’étape 2 pour dissimuler le ver affiché. 

Maintenant, il ne reste plus qu’à définir la « couche sonore » de l’application, c’est-à-dire 
la musique d’arrière-plan et les deux bruitages. 
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Musique d’arrière-plan 


Nous avons déjà vu cette technique dans un chapitre précédent. Elle consiste à mettre 
en place un objet AVAudioPlayer. Commencez par cliquer sur la première entrée 
dans le volet de navigation, basculez sur l’onglet Build Phases, développez l’élément 
Link Binary with Libraries et ajoutez les frameworks AVFoundation.framework 
et AudioToolbox . framework. 

Cliquez sur ViewController .h dans le volet de navigation et faites référence aux deux 
frameworks avec des instructions #import : 

1 #import <AVFoundation/ AVFoundation . h> 

2 #import < AudioToolbox / AudioToolbox . h> 


Toujours dans le fichier d’en-têtes, implémentez le protocole AVAudioPlayerDelegate : 

1 ©interface ViewController : UlViewController < 
AVAudioPlayerDelegate > 


Enfin, définissez les objets suivants : 

- audioPlayer de classe AVAudioPlayer ; 

- bruit de classe SystemSoundlD ; 

- rire de classe SystemSoundlD. 


1 

2 

3 

4 

5 

6 
7 


©interface ViewController : UlViewController < 
AVAudioPlayerDelegate > 

{ 


AVAudioPlayer ♦audioPlayer; 
SystemSoundlD bruit; 
SystemSoundlD rire; 


Pour activer la musique de fond et rendre accessibles les deux effets spéciaux, ajoutez 
les instructions suivantes dans la méthode viewDidLoad : 


1 

2 

3 

4 

5 


6 

7 

8 
9 

10 


AudioSes s ionlnit ial ize (NULL, NULL, NULL, (__bridge void *)self 

) ; 

UInt32 sessionCategory = kAudio Ses s i onCat egory _MediaP layback ; 

Audio Ses s ionSe tPr opert y ( kAudi oSes s ionPr opert y _ AudioCat egor y , 
sizeof (sessionCategory), & se s s i onCat egory ) ; 

NSData * soundFileData ; 

soundFileData = [NSData dat aWi thC ont ent s Of URL : [NSURL 

f ileURLWithPath : [ [NSBundle mainBundle] pathForRes our ce : © " 
morceau. mp3" of Type : NULL ]]] ; 

audioPlayer = [[AVAudioPlayer alloc] initWi thDat a : s oundFileDat a 
err or : NULL ] ; 

audioPlayer . delegate = self ; 

[audioPlayer setVolume : 1 . 0] ; 

[audioPlayer play]; 
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11 


12 


AudioServicesCreateSystemSoundlD ( CFBundleCopyRes our ceURL ( 

CFBundleGetMainBundle () , CFSTR ( " pong " ) , CFSTR ( " caf " ) , NULL), 
ftbruit ) ; 

AudioServicesCreateSystemSoundlD ( CFBundleCopyRes our ceURL ( 

CFBundleGetMainBundle () , CFSTR (" rire " ) , CFSTR (" caf ") , NULL), 
ftrire ) ; 


j Copier ce code 

[ Code web : 247031 y 

Les lignes 1 à 9 mettent en place la musique de fond, comme nous l’avons vu dans le 
chapitre consacré au son. Les lignes 11 et 12 mettent en place les sons bruit et rire. 

Et voilà, l’application est entièrement opérationnelle. J’espère que vous avez pris autant 
de plaisir que moi à la développer ! 

Si vous testez cette application dans le simulateur iOS 5.0, il se peut que vous 
obteniez une erreur à rallonge dans la console. Ne vous en faites pas : cette 
erreur n'en est pas vraiment une et l'application fonctionne à la perfection 
sur un iPhone, un iPod Touch ou un iPad tournant sous iOS 5. Un correctif 
devrait être intégré dans les prochaines mises à jour de Xcode. Si cette erreur 
vous dérange vraiment, vous pouvez opter pour une solution alternative. 



| Voir la solution alternative 
[ Code web : 510881 , 

L’application se trouve dans le dossier ver. Voici le code de ses deux principaux fichiers. 


> 


Télécharger le projet 
^Code web : 357752 


ViewController .h 


1 

2 

3 

4 

5 


# import CUIKit/UIKit .h> 

#import < AVFoundat ion/ AVFoundat ion .h> 

#import < AudioToolbox/ AudioToolbox .h> 

^interface ViewController : UI ViewCont r o lier < 
AVAudioPlayerDelegate > 


6 { 


7 

NSTimer *timerl 

J 



8 

int état ; 

II 

État du 

jeu 

9 

int compteur ; 

// 

Compteur 

de départ de jeu 

10 

f loat leTemps ; 

/ / 

Durée de 

1 ' état actuel 

11 

int largeur ; 

II 

Largeur 

de 1 ' é cran 

12 

int hauteur ; 

II 

Hauteur 

de 1 1 é cran 

13 

f loat posX ; 

II 

Position 

en X du ver 

14 

f loat posY ; 

II 

Position 

en Y du ver 

15 

int aTouche ; 

// 

1 si le 

joueur a touché 1 

16 

int reus s i ; 

// 

Nombre de vers capturés 


écran , 


0 sinon 
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17 

18 

19 

20 
21 
22 

23 

24 

25 


int rate; // Nombre de vers râtés 

AVAudioPlayer * audioPlayer ; 

SystemSoundlD bruit; 

SystemSoundlD rire; 

} 

(Sproperty (weak, nonatomic) IBOutlet UlImageView *leVer; 
Sproperty (weak, nonatomic) IBOutlet UILabel * leMes sage ; 
®end 


ViewController .m 


1 

2 

3 

4 

5 

6 

7 

8 
9 

10 

11 

12 

13 

14 

15 

16 

17 

18 

19 

20 
21 
22 

23 

24 

25 

26 

27 

28 

29 

30 

31 

32 

33 

34 

35 

36 

37 


#import "ViewController . h" 

#include <stdlib.h> 

Oimplementation ViewController 
®synthesize leVer; 

®synthesize leMessage; 

- ( vo id ) didRe cei veMemory Warning 

{ 

[super didReceiveMemoryWarning] ; 

// Release any cached data, images, etc that aren ' t in use. 

} 

#pragma mark - View lifecycle 

-(void) boucleJeu 

{ 

switch(etat) 

{ 

case 0 : 

// Décompte de départ 
if (compteur == 4) 

{ 

[leMessage setText : @ " Attent ion " ] ; 
compteur - - ; 

} 

else if ((compteur >=1) && (compteur <=3)) 

{ 

leMessage . text = [NSString stringWithFormat : @"'/,i 

compteur] ; 
compteur - - ; 

} 

else if (compteur == 0) 

{ 

[leMessage setText : @ "C ' est à vous !"]; 
compteur = 4; 

état = 1; //Affichage d'un ver 

} 
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39 

40 

41 

42 

43 

44 

45 

46 

47 

48 

49 

50 

51 

52 

53 

54 

55 

56 

57 

58 

59 

60 

61 

62 

63 

64 

65 

66 

67 

68 

69 

70 

71 

72 

73 

74 

75 

76 

77 
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break ; 
case 1 : 

// Affichage du ver 

posX = ( ar c4random ( ) / (largeur - 60)) + 30; 
posY = ( ar c4random ( ) '/, (hauteur - 60)) + 30; 
leVer. center = CGPointMake (posX , posY); 
leVer. alpha = 1 . Of ; 

leTemps = ( ar c4random ( ) */, 3) + 1; //Nombre aléatoire 

entre 1 et 3 
[timerl invalidate]; 

timerl = [NSTimer s cheduledTimerWi thTimelnterval : leTemps 
target : self selector : Oselector (boucle Jeu) userlnf o : nil 
repeat s : YES ] ; 
état = 2 ; 
aTouche = 0 ; 
break ; 
case 2 : 

// Disparition du ver 
if (aTouche == 0) 

{ 

rate++; // Sinon, le joueur n'a pas eu le temps de 
toucher l'écran, donc le ver est raté 
leMessage . text = [NSString stringWithFormat : @"Vers 
attrapés ’/.i ratés '/, i ", réussi , rate]; 

Audio Servi cesPlaySystemSound (rire) ; 

} 

leVer . alpha = 0 . Of ; 
leTemps = 0 . 5f ; 

[timerl invalidate]; 

timerl = [WSTimer s cheduledTimerWi thTimelnterval : leTemps 
target : self selector : Sselector (boucle Jeu) userlnfo :nil 
repeat s : YES ] ; 
état = 1 ; 
break ; 

} 

} 

-(void) t ouchesBegan : ( NSSet ♦) touches withEvent : ( UIEvent *) 
e vent 

{ 

aTouche = 1; // Le joueur a touché l'écran 

UITouch *touch = [[event allTouches] anyObject]; 

CGPoint location = [touch locationlnView : touch . view] ; 
if ( ( abs ( locat i on . x - posX)<30) && ( abs ( lo cat ion . y - posY)<30 
)) 

{ 

reus s i ++ ; 

AudioServicesPlaySystemSound (bruit) ; 

} 

else 
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80 

81 

82 

83 

84 

85 

86 

87 

88 

89 

90 

91 

92 

93 

94 

95 

96 

97 

98 

99 

100 

101 

102 

103 

104 

105 

106 

107 

108 

109 

110 

111 

112 

113 

114 
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{ 

Audio Servi ce sPlaySy s temSound ( rire ) ; 
rate ++ ; 

} 

leMessage . text = [NSString stringWithFormat : @"Vers attrapés 
/ i ratés ’/, i ", réussi , rate]; 

// Affichage d'un autre ver 

[timerl invalidate]; 

timerl = [NSTimer s cheduledTimerWi thTimelnt erval : 0 . Of target : 
self selector : Oselector (boucle Jeu) userlnfo :nil repeats: 
YES] ; 
état = 2; 


- ( void ) viewDidLoad 

{ 

[super viewDidLoad]; 

// Arrière-plan 

self . view . backgroundColor = [[UlColor alloc] 

initWithPatternlmage : [UI Image imageNamed : @ " fondver.jpg"]] ; 

// Audio 

Audio Ses s ionlnit ial ize (NULL, NULL, NULL, (__bridge void *) 
self ) ; 

UInt32 s es s ionCat egory = k Audio Ses s i onCat egory _MediaP layback ; 

Audio Ses s ionSetPr opert y (kAudioSessionProperty_AudioCategory , 
sizeof ( s es s ionCat egory ) , & ses s ionCat egory ) ; 

NSData * soundFileData ; 

soundFileData = [NSData dat aWi thC ont ent s Of URL : [NSURL 

f ileURLWithPath : [ [NSBundle mainBundle] pathForResource : @ " 
morceau. mp3" of Type : NULL ]]] ; 

audioPlayer = [ [ AV Audi oPlayer alloc] initWithData : 

soundFileData error:NULL]; 

audioPlayer . delegate = self; 

[audioPlayer setVolume : 1 . 0] ; 

[audioPlayer play]; 

AudioServicesCreateSystemSoundlD ( CFBundleC opyRes our ceURL ( 

CFBundleGetMainBundle () , CFSTR ( " pong " ) , CFSTR ( " caf " ) , NULL 
) , ftbruit ) ; 

AudioServicesCreateSystemSoundlD ( CFBundleC opyRes our ceURL ( 

CFBundleGetMainBundle () , CFSTR (" rire ") , CFSTR (" caf ") , NULL 
) , ftrire ) ; 


// Timer 






état = 

0; 

// 

État 0 

au 

départ 

du jeu : message de départ 

reus s i 

= 0; 

// 

Aucun 

ver 

capturé 

au départ 

rate = 

0; 

// 

Aucun 

ver 

raté au 

départ 
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116 

117 

118 

119 

120 

121 

122 

123 

124 

125 

126 

127 

128 

129 

130 

131 

132 

133 

134 

135 

136 

137 

138 

139 

140 

141 

142 

143 

144 

145 

146 

147 

148 

149 

150 

151 

152 

153 

154 

155 

156 

157 

158 
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compteur =4; // Compteur au départ du jeu 

largeur = self . view . bounds . size . width ; // Largeur 

hauteur = self . view . bounds . size . height ; // Hauteur 

timerl = [NSTimer s cheduledTimerWi thTime Int erval : 1 . 
self select or : Oselect or ( bouc le Jeu ) userlnfo :nil 
YES] ; 

} 

- ( void) viewDidUnload 

{ 

[self setLeVer : nil] ; 

[self setLeMessage : nil] ; 

[self setLeVer : nil] ; 

[super viewDidUnload]; 

// Release any retained subviews of the main view. 
// e.g. self . myOut let = nil; 

} 

- (void) viewWill Appear : (B00L) animated 

{ 

[super viewWillAppear : animated] ; 

} 

- (void) viewDidAppear : (B00L) animated 

{ 

[super viewDidAppear : animated] ; 

} 

- (void) viewWillDis appear : (B00L) animated 

{ 

[super viewWillDisappear : animated] ; 

} 

- (void) viewDidDisappear : (B00L) animated 

{ 

[super viewDidDisappear : animated] ; 

} 

- (B00L) shouldAutorotateTo Interface Orientât ion : ( 

UlInterfaceOrientation) interf aceOrientation 

{ 

// Return YES for supported orientations 
return ( int erf ace Or ient at ion ! = 

UIInterfaceOrientationPortraitUpsideDown) ; 

} 


de 1 ' é cran 
de 1 ' é cran 
Of target : 
repeat s : 


<Send 


Cinquième partie 

Tester et publier ses applications 
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Chapitre 



Gestion des matériels et des identités 
numériques 


Difficulté : — 

C e chapitre ne s'intéresse pas à la publication des applications; c'est encore trop tôt. 
Par contre, vous y apprendrez à tester vos applications, dans le simulateur 1 et sur 
device. Vous verrez également comment mettre à jour la version du système iOS sur 
un device et comment effectuer des captures d'écran. 

Tous ces points sont autant d'étapes nécessaires avant la publication. 

Mais assez palabré, commençons sans plus attendre! 



1. Ce chapitre revient sur des choses déjà vues précédemment ; c’est une piqûre de rappel. 
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CHAPITRE 23. GESTION DES MATÉRIELS ET DES IDENTITÉS 
NUMÉRIQUES 


Déboguer une application 

Il est très important de tester (on dit aussi « déboguer ») vos applications afin de vous 
assurer que vous avez envisagé toutes les situations. Par expérience, je peux vous assurer 
que les utilisateurs font souvent des manipulations « étranges » et parfois totalement 
illogiques. Au-delà de ça, vous n’êtes pas à l’abri d’une erreur dans votre code. Il est 
donc capital de tester et de retester vos applications avant de les distribuer. 

Pour cela, vous utiliserez le volet de débogage de Xcode. Grâce à lui, vous pourrez 
contrôler la valeur des variables utilisées dans l’application pendant son exécution. 
Pour afficher le volet de débogage, il suffit de cliquer sur l’icône Hide or show the 
Debug area, dans la barre d’outils de Xcode, comme le montre la figure 23.1. 



Figure 23.1 - Affichage du volet de débogage 


Affichage d’informations depuis le code 

Une des façons les plus simples d’afficher des éléments textuels dans le volet de débogage 
consiste à utiliser la fonction NSLogO : 

l| HSLog (<§" texte à afficher"); 

Si vous voulez afficher le contenu d’une variable, vous devez préciser son type dans les 
guillemets, puis indiquer la variable à afficher à la suite du deuxième guillemet. Par 
exemple, pour afficher la valeur d’une variable de type int, vous pouvez écrire quelque 
chose comme ceci : 

l| HSLog(@"Le résultat est : résultat); 

Ou encore, pour afficher la valeur d’une variable de type NSString, vous pouvez écrire 
quelque chose comme ça : 
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l| NSLog(@"Le résultat est : @"un texte quelconque"); 

Le langage Objec.tive-C peut utiliser de nombreux types de variables. Nous les avons 
résumés dans le tableau ci-après. 


Type 

Signification 

7 .@ 

NSString 

°/.d, %i 

Entier signé 

‘/.U 

Entier non signé 

y.f 

Float/double 

“/.x, "/.X 

Entier hexadécimal 

lo 

Entier octal 

y.p 

Pointeur 

le 

Float/double en notation scientifique 

'/.s 

String C (bytes) 

1S 

String C (unichar) 

le 

Caractère 

IC 

Unichar 

llld 

Long long 

•/.nu 

Long long non signé 

iLf 

Long double 


Le texte à afficher peut contenir un ou plusieurs caractères de mise en forme, tels 
qu’un passage à la ligne ou une tabulation. Ces caractères sont appelés « séquences 
d’échappement ». Je les ai résumées dans le tableau suivant. 


Séquence 

Effet 

\ n 

Ligne suivante 

\r 

Paragraphe suivant 

\t 

Tabulation horizontale 

V 

Tabulation verticale 

w 

Antislash 

\« 

Guillemet dans une chaîne 

V 

Apostrophe dans une chaîne 


Par exemple, cette instruction : 

1 | NSLog(@"Ce texte est affiché \n sur deux lignes") ; 

Produit l’affichage suivant dans le volet de débogage : 

[...] test [935 : 207] Ce texte est affiché 
sur deux lignes 
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Affichage d’informations depuis le volet de débogage 


Il est également possible d’insérer un point d’arrêt dans le code. Cliquez dans la marge, 
à gauche de la ligne de code sur laquelle vous voulez arrêter l’exécution. Une marque 
bleue est affichée, comme sur la figure 23.2. 



-( IBAction) reagir: ( id) sender 
{ 

NSString ♦lemessage = [[NSString alloc] 

messaqe. text = lemessage; 

i++; 

} 


initWithFormat:@"Bravo !"]; 


Figure 23.2 - La marque bleue dans la marge indique un point d’arrêt dans le code 


Lorsque vous lancez l’application, l’exécution est arrêtée sur la ligne ainsi marquée. 
Pour avoir des informations sur un des objets manipulés dans l’application, tapez « po » 
suivi du nom de l’objet dans la console. 


Souscrire au programme de développement iOS 

Pourquoi devrais-je souscrire au programme de développement iOS? 

Eh bien, sachez que c’est une étape nécessaire pour : 

1. tester vos applications sur device (et non dans le simulateur iOS) ; 

2. distribuer vos applications. 

Une mauvaise nouvelle : le programme de développement n’est pas gratuit. De plus, 
Apple en propose trois déclinaisons et vous devrez choisir celle qui s’adapte à vos 
besoins. 

Vous pouvez ainsi opter pour : 

- la version standard individuelle : 79 euros par an ; 

- la version standard entreprise : 79 euros par an ; 

- la version grande entreprise : 199 euros par an. 



La version standard individuelle 

Elle fait partie du programme iOS Developer Program. Elle s’adresse aux dévelop- 
peurs individuels. Par son intermédiaire, ils peuvent créer des applications iOS gratuites 
ou commerciales, les tester sur un ou plusieurs devices (jusqu’à 100), puis les distribuer 
sur l’App Store sous leur propre nom. 
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L'App Store est le site Web officiel de vente d'applications pour iPhone, iPod 
Touch, et iPad. 


La version standard entreprise 

Elle fait également partie du programme iOS Developer Program, mais elle permet 
de gérer une équipe de développeurs. Par son intermédiaire, une entreprise peut créer 
des applications iOS gratuites ou commerciales, les tester sur un ou plusieurs devices 
(jusqu’à 100), puis les distribuer sur l’App Store sous le nom de l’entreprise. 


La version grande entreprise 

Elle fait partie du programme iOS Developer Enterprise Program. Elle est destinée 
aux entreprises de plus de 500 salariés. La distribution des applications se fait à travers 
une sorte d’App Store d’entreprise, et non via l’App Store d’Apple. Chaque application 
peut être déployée sur un nombre illimité de devices. 

Pour souscrire à la version standard individuelle ou standard entreprise, rendez-vous sur 
la page iOS Developer Program, cliquez sur Enroll Now et suivez les étapes indiquées 
sur l’écran. 

Iversion standard 

[ Code web : 621357 y 

Pour souscrire à la version grande entreprise, rendez-vous sur la page iOS Developer 
Enterprise Program, cliquez sur Apply Now et suivez les étapes indiquées sur l’écran. 

Version grande entreprise 
^ Code web : 332828 y 


Souscription à la version standard individuelle 

À titre d’exemple, et parce que ce cas correspond à la majorité d’entre vous, nous allons 
examiner le processus de souscription à la version standard individuelle, c’est-à-dire au 
programme dédié aux développeurs individuels. 

Pour souscrire à un programme de développement, vous devez au préalable 
avoir rejoint la communauté des développeurs Apple. Cette étape a été décrite 
dans la section « Les logiciels nécessaires » du chapitre 1 (page 12). Consultez 
cette section si vous n'avez pas encore fait ce premier pas. 

Rendez-vous sur la page iOS Developer Program et cliquez sur Enroll Now (figure 
23.3). 

Un message vous avertit que vous devez disposer d’un Mac équipé d’un processeur Intel 
et utiliser le système d’exploitation Mac OS X Snow Léopard ou ultérieur. Cliquez sur 
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Figure 23.3 - Rendez-vous sur la page iOS Developer Program et cliquez sur Enroll 
Now 


Continue pour poursuivre votre inscription. 

Vous devez maintenant vous situer dans l’univers Apple. Cochez la case correspondant 
à votre cas (figure 23.4) : 

- « I need to create. . . » si vous n’avez pas encore un identifiant Apple ID ; 

- « I hâve an Apple ID . . . » si vous avez un Apple ID mais que vous n’avez pas 
encore rejoint la communauté des développeurs Apple; 

- « I’m registered as . . . » si vous avez rejoint la communauté des développeurs 
Apple mais pas encore le iOS Developer Program; 

- « I ’m currently enrolled. . . » si vous avez déjà adhéré au Mac Developer Pro- 
gram et que vous voulez y ajouter le iOS Developer Program. 

Si vous avez suivi mes indications, vous devez avoir rejoint la communauté des déve- 
loppeurs Apple et vous êtes sur le point d’adhérer au iOS Developer Program. À 
ce titre, sélectionnez la troisième case et cliquez sur Continue. 

Comme nous l’avons dit précédemment, le iOS Developer Program peut s’appliquer 
à un développeur individuel ou à une entreprise. Dans la page suivante, vous devez 
choisir l’une ou l’autre de ces deux options. 

Comme vous pouvez le voir, le nom affiché en face des applications dans l’App Store 
sera différent selon que vous vous enregistriez en tant que développeur individuel ou 
en tant qu’entreprise. Dans le premier cas, votre nom sera associé aux applications 
postées sur l’App Store. Dans le deuxième cas, c’est le nom de votre société qui leur 
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Figure 23.4 - Cochez la case correspondant à votre cas 


sera associé. 

O Si vous vous enregistrez en tant que développeur individuel et que, par la suite, 
vous devenez une société, vous pourrez changer votre statut en conséquence 
en vous connectant à nouveau sur la page iOS Developer Program. 

Cliquez sur Individual et entrez vos identifiants Apple. 

Dans la prochaine étape, vous devez entrer vos coordonnées, telles qu’elles apparaissent 
sur votre carte de crédit. Complétez le formulaire pré- rempli et cliquez sur Continue. 

Vous devez alors choisir le programme auquel vous voulez adhérer. Cochez la case iOS 
Developer Program (figure 23.5) et cliquez sur Continue. 

L’étape suivante résume les informations que vous avez entrées. Cette vérification ef- 
fectuée, cliquez sur Continue. 

L’étape suivante décrit les termes du contrat de licence entre vous et Apple. Vérifiez 
que vous êtes en accord avec tous ces termes, cochez la case By checking this box . . . 
et validez en cliquant sur I Agréé. L’écran suivant vous invite à ajouter le programme 
dans votre caddie. Cliquez sur Add to Cart. Cliquez enfin sur Passer la commande 
(figure 23.6). 

Il se peut que vous soyez invités à entrer vos identifiants Apple. Dans ce cas, 
tapez votre Apple ID et le mot de passe associé puis validez. 
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Figure 23.5 - Vous devez choisir le programme auquel vous voulez adhérer 



Figure 23.6 - « Passer la commande » 
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Validez en cliquant sur Continuer à trois reprises. Entrez les informations relatives 
à votre carte de paiement et validez. Après quelques instants, une page vous indique 
que votre commande est en cours de traitement. Il ne vous reste plus qu’à attendre sa 
validation par Apple, ce qui devrait se faire dans les 24 prochaines heures. 

Une fois votre souscription au programme de développement validée par Apple, vous 
recevez deux e-mails. 

Le premier vous remercie d’avoir rejoint le programme de développement iOS et donne 
accès au portail des développeurs Apple (figure 23.7). 


• Developer 

Thank You for Joining an Apple Developer Program 

Dear Michel Martin, 

Thank you for joining the iOS Developer Program You now hâve access to a comprehensive 
set of development tools and resources to asslst you in developtng mnovative apps 

Please feel free to contact us tfvou hâve any general questions or require assistance 
Best regards. 

Apple Developer Support 



TM and copyright Ç 2010 Apple Ine. 1 Infinité Loop. MS 303-3DM. Cupertino. CA 93014. 
Ail Riqht? Rcseryed .' Kenp Informée / Pnvaçy Ppliç y / My Info 


Figure 23.7 - Portail des développeurs Apple 


Cliquez sur Log in now pour accéder au site dédié aux développeurs. Vous y trouverez : 

- des ressources techniques liées au développement pour devices iOS ; 

- un ensemble de questions/réponses sur la soumission des applications sur l’App 
Store ; 

- un forum dédié aux développeurs, dans lequel vous pourrez poser vos questions et 
consulter les questions/réponses des autres développeurs; 

- un accès au portail d’approvisionnement, pour tester vos applications sur device; 

- un accès à iTunes Connec.t, pour soumettre vos applications sur l’App Store; 

- un accès au support technique Apple. 



Comme souvent en informatique, toutes ces ressources sont en anglais. 
Rassurez-vous, l'anglais technique est bien plus simple que celui que vous 
avez appris au lycée. 


Le deuxième e-mail donne le lien permettant d’accéder directement à iTunes Connect 
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(figure 23.8). 


V iTunes Connect 


Dear Menai Marte, 

You now hâve accès» to iTunes Connect. our exctiv.e partner-facwg website y ou mey access iTunes Connect usmg ttie Ink below 


inesC 


Log n use 9 me existe g usema/ne and password for your Apple Develooer account 

Wih iTunes Connect you cen enter rrto a Pad Apptcatons agreement setup and e<M r formation about your appàcetmn. vew sales 
and trend e formater., retneve fnanciai reporta fit applcaoie > and croate ne w user accounta for othar peopie at your company 

If you bave any questions regarding your iTunes Connect account piease nd Us, 

Best Regards 
The App Store Team 


Figure 23.8 - iTunes Connect 

En cliquant sur le lien « iTunes Connect » , vous pourrez gérer facilement les applications 
soumises à l’App Store (ventes, contrats, taxes, etc.), comme le montre la figure 23.9. 



Figure 23.9 - Vous pourrez gérer facilement les applications soumises à l’App Store 


Certificats et profils d’approvisionnement 

Pour pouvoir tester vos applications sur un ou plusieurs devices, puis les poster sur 
l’App Store, vous allez devoir créer des certificats et des profils d’approvisionne- 
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CERTIFICATS ET PROFILS D APPROVISIONNEMENT 


ment. Il y a de grandes chances pour que ces deux termes ne fassent pas partie de 
votre vocabulaire (du moins en ce qui concerne l’univers iOS). Alors voyons sans plus 
attendre de quoi il s’agit. 

Les certificats sont stockés sur votre Mac. Ils permettent d’identifier : 

- un développeur : certificat de développement ; 

- un compte de développement : certificat de distribution. 

Les profils d’approvisionnement sont stockés sur le device. Ils servent de lien entre un ou 
plusieurs certificats, un identifiant d’application et des périphériques, afin de sécuriser 
la diffusion d’applications. On distingue : 

- les profils d’approvisionnement de développement, qui permettent d’autoriser un ou 
plusieurs développeurs à déployer une application sur des devices spécifiques ; 

- les profils d’approvisionnement de déploiement qui permettent de diffuser des appli- 
cations à plus grande échelle, notamment sur l’App Store, mais également en mode 
« in-house » à l’intérieur d’une grande entreprise. 


Créer un profil d’approvisionnement 

Pour tester vos applications sur un device (et non dans le simulateur iOS), vous allez 
devoir créer un profil d’approvisionnement sur le portail. . . Commencez par relier votre 
device sur un port USB de votre Mac. L’application iTunes démarre automatiquement. 
Pour l’instant, vous n’en aurez pas besoin. Vous pouvez la fermer ou la replier pour 
libérer le bureau. 

Lancez Xcode en cliquant sur son icône dans le dock. Déroulez le menu Window et 
cliquez sur Organizer. Cliquez si nécessaire sur l’icône Devices dans la barre d’outils 
de l’application Organizer et sélectionnez votre device dans le volet droit. Une boîte de 
dialogue similaire à la figure 23.10 est affichée. 

Cliquez sur Use for Development. Connectez-vous sur le portail des développeurs 
Apple, entrez vos identifiants et cliquez sur iOS Provisioning Portai, puis sur Launch 
Assistant dans le cadre Get your application on an iOS. . . (figure 23.11). 



Portail des développeurs 
Code web : 870612 


Cette action lance l’assistant d’approvisionnement. Cliquez sur Continue, choisissez 
un nom pour identifier votre App ID et cliquez sur Continue (figure 23.12). 

Décrivez votre device et copiez-collez son identifiant depuis la fenêtre Organizer dans 
la fenêtre de l’assistant, comme indiqué à la figure 23.13. 

Cliquez sur Continue. L’assistant vous demande de lancer l’application Keychain, soit 
« Trousseau d’accès » en français. 

Cliquez sur l’icône Applications dans le dock, puis sur l’icône Utilitaires dans le 
dossier des applications. Lancez enfin l’application Trousseau d’accès. 
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Organizer - Devices 

l £ü a u 

Devices Repositories Projects Archives Documentation 


LIBRARY 

JL Developer Profile 
[J Provisioning Profiles 
* Software Images 
Device Logs 
Screenshots 


Device Logs 
~V Screenshots 


iPhone 

Capactty 15.53 CB 
Model iPhone 3G 
trial Number MMWR 
ECID MMUM 
Identifier 

ivare Version 4.2.1 (8C148) 


Use for Development 


Add to Portai Remove 


Figure 23.10 - Une boîte de dialogue s’affiche 



Get your application on an iOS with the Development 
Provisioning Assistant 

As a Program Admin, you can use the Development Provisioning 
Assistant to create and install a Provisioning Profile and iOS 
Development Certificate needed to build and install applications you're 
developing for iOS devices. 

[ Launch Assistant^ J 


Figure 23.11 - Cliquez sur Launch Assistant 
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Figure 23.12 - Choisissez un nom pour identifier votre App ID et cliquez sur Continue 



Figure 23.13 - Copiez-collez l’identifiant 
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Cette application va générer une demande de signature. Cette étape doit 
s'effectuer une fois (et une seule) pour chaque device que vous utiliserez pour 
tester vos applications. 


Cliquez sur le menu Trousseau d’accès, pointez Assistant de certification et 
cliquez sur Demander un certificat à une autorité de certificat, comme à la 
figure 23.14. 


Fichier Edition Présentation Fenêtre Aide 


À propos de Trousseau d'accès 


Préférences... 

X, 

S.O.S. Trousseau 

XX A 

Visualiseur de ticket 

XXK 

Services 

► 

Masquer Trousseau d'accès 
Masquer les autres 

XH 

XXH 

Quitter Trousseau d'accès 

*Q 


Ouvrir ... 

Créer un certificat... 

Créer une autorité de certificat... 

Créer un certificat pour quelqu'un d'autre en tant qu'autorité de certificat.. 


Demander un certificat à une autorité « 


Définir l'autorité de certificat par défaut.. 
Évaluer un certificat... 


Figure 23.14 - Demander un certificat à une autorité de certificat 

Cette action déclenche l’affichage de la boîte de dialogue Assistant de certification. 
Assurez-vous que les zones Adresse électronique de 1 ’utilisateur et Nom commun 
soient correctement remplies. Sélectionnez l’option Enregistrée sur disque et cochez 
la case Me laisser indiquer les informations sur la bi-clé, comme sur la fi- 
gure 23.15. 


« n 


Assistant de certification 


Informations sur le certificat 


Saisissez les informations relatives au certificat que vous 
demandez. Cliquez sur Continuer pour demander un 
certificat de PAC. 


Adresse électronique de l'utilisateur : lem.korp@free.fr 
Nom commun : Michel Martin 




Adresse électronique de l'AC : 

La requête est : O Envoyée à autorité de certif. par courriel 
© Enregistrée sur disque 

(VJ Me laisser indiquer les informations sur la bi-clé 


(_ Continuer ) 


Figure 23.15 - Remplissez la boîte de dialogue Assistant de certification 
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Je veux bien entrer les informations correspondant à la bi-clé, mais j'ai un 
petit problème : qu'est-ce qu'une bi-clé au juste? 

Les bi-clés sont composées d’une clé publique et d’une clé privée. 

- La clé publique sert à chiffrer des données. Elle n’est pas secrète et peut être librement 
partagée avec tout le monde. 

- La clé privée est la partie secrète d’une bi-clé. Elle sert à déchiffrer des données. Elle 
doit rester confidentielle. 

Les bi-clés utilisent un programme spécifique pour transformer l’information contenue 
dans un texte lisible en des données chiffrées, et inversement. Cliquez sur Continuer 
et choisissez le dossier dans lequel sera stocké le certificat. 

Cliquez sur Enregistrer et choisissez 2048 bits dans la zone de texte Dimension de 
la clé et RSA dans la zone de texte Algorithme (figure 23.16). 



« o 


Assistant de certification 


Informations de bi-clé 


Indiquez la taille de clé et l’algorithme utilisé pour la 
création de votre bi-clé. 

La bi-clé est composée de vos clés privée et publique. La clé 
privée est la partie secrète du bi-clé ; elle doit rester 
confidentielle. La clé publique est rendue publique au sein 
du certificat numérique. 


2 048 bits 

I] 


RSA 

_z 


( En savoir plus... j 


C 


Continuer 


A 


Figure 23.16 - Choisissez une dimension de clé et un algorithme 


Qu'est-ce que la taille d'une clé? Et pourquoi avoir choisi 2048 bits? 


La taille d’une clé est mesurée en « bits », ou « informations binaires ». Plus une clé 
est grande, plus il est difficile de la décrypter. Une taille avoisinant les 2000 bits est 
appropriée pour une clé que vous comptez utiliser pendant quelques années. Si vous 
désirez utiliser votre clé plus longtemps, vous pouvez utiliser une clé de plus grande 
taille. Par exemple de 3000 ou 4000 bits. 
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Cliquez sur Continuer. Après un bref instant, l’Assistant vous informe que le certificat 
a été enregistré sur votre disque dur. Vous pouvez cliquer sur Terminer pour fermer la 
boîte de dialogue de l’Assistant de certification. 

Maintenant que le certificat a été créé, vous pouvez retourner dans l’Assistant d’appro- 
visionnement. Cliquez sur Continue, sur Choisir le fichier, désignez le certificat 
puis cliquez sur Continue. Vous devez maintenant donner un nom au profil d’approvi- 
sionnement. À la figure 23.17, j’ai choisi « iPhone3G ». 



Figure 23.17 - Il faut donner un nom au profil d’approvisionnement 

Cliquez enfin sur Generate. Au bout de quelques secondes, le profil est généré, comme 
à la figure 23.18. 

Cliquez sur Continue. La prochaine étape va consister à télécharger le profil d’appro- 
visionnement dans votre Mac, puis à l’installer sur votre device. Cliquez sur Download. 

Une fois le fichier téléchargé, cliquez dessus avec le bouton droit de la souris dans la 
fenêtre Téléchargements et sélectionnez Afficher dans le Finder. Assurez-vous que 
votre device est connecté au Mac, puis glissez-déposez le fichier sur l’icône Xcode du 
dock (figure 23.19). Cette action déclenche l’installation du fichier d’approvisionnement 
dans le device. 

Retournez dans l’Assistant d’approvisionnement et cliquez sur Continue à deux re- 
prises. Maintenant, vous pouvez vérifier que votre profil est bien affiché dans la section 
Provisioning de la fenêtre Organizer de Xcode, comme à la figure 23.20. 

Retournez dans l’Assistant d’approvisionnement et cliquez sur Continue. Vous êtes 
maintenant invités à télécharger le certificat de développement iOS sur le Mac (figure 
23.21). Cliquez sur Download. 
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Figure 23.18 - Le profil est généré 



Figure 23.19 - Glissez-déposez le fichier sur l’icône Xcode du dock 
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« 0 0 


X Developer Profile 
[J Provisionirvg Profiles 
• Software Images 

V Screenshots 

DCVICtS 

a 

[J Provisromng Profiles 
A Applications 
| Console 
Device Logs 
êP Screenshots 




iPhone 


Capacity 15.53 CB 
Model iPhone 3C 
Serial Number MMfAB 

ICID MMMM* 

i I (8048) îj • 


Provisionmg iPhoneiC O 


Aophcati ru No developed applications O 

S FairPlay-encrypted applications 


Oevite legs No Device logs O 
Screr . i ■ No screenshots O 


O O 


Figure 23.20 - Le profil est bien affiché 



Figure 23.21 - Vous êtes invités à télécharger le certificat de développement iOS sur 
le Mac 
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Au bout de quelques instants, un fichier nommé developer_identy . cer est téléchargé 
et placé dans le dossier Téléchargements de votre Mac. Double-cliquez sur ce fichier 
et ajoutez le certificat à un trousseau (figure 23.22). 


** Ajouter des certificats 


"Ht 


Souhaitez-vous ajouter le(s) certificat(s) du fichier « 
developer Jdentity.cer » à un trousseau ? 


Trousseau : 


Afficher les certificats 


( _ Annuler ^ ( Ajouter ) 


Figure 23.22 - Ajoutez le certificat à un trousseau 

Cliquez sur Ajouter. L’Assistant d’approvisionnement vous demande de vérifier que 
les clés privées et publiques ont bien été générées et liées au certificat de développeur. 

Rendez-vous dans la fenêtre Trousseau d’accès et cliquez sur Clés dans le groupe 
Catégorie. Vous devriez obtenir quelque chose ressemblant à la figure 23.23. 


« O 

Trousseau d'accès 



i ‘ Cliquez pour verrouiller le trousseau session. 



Trousseaux 

Michel Martin 

Type . clé publique. RSA. 2048-blt 
Utilisation Quelconque 

Nom 



u session 



A Système 

O Racines du système 


Date de 


j; Michel Martin 

dé publique 



▼ Ç Michel Martin 

clé privée 


Catégorie 

bd IPhone Developer: Michel Martin (JPU8Q3DHT9) 

certificat 

-- 

Ü Tous les éléments 
Mots de passe 




Notes sécurisées 




Q Mes certificats 




? Clés 

1 



S Certificats 

t 



HD 

n b t r ••••« 



Figure 23.23 - Les clés sont bien présentes 

Retournez dans l’Assistant d’approvisionnement et cliquez sur Continue. La prochaine 
fenêtre (figure 23.24) vous montre comment installer votre application avec Xcode. 

Il ne vous reste plus qu’à installer votre application sur le device. Cliquez sur Continue 
puis sur Done. 
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Figure 23.24 - La fenêtre vous montre comment installer l’application avec Xcode 

J’espère que vous avez tenu le coup : l’étape que nous venons de voir est longue mais 
nécessaire pour l’installation d’une application sur un device. 


Travailler sur un device 

Installer une application iOS sur un device depuis Xcode 

Voici les étapes qui vous permettront d’installer une application iOS sur un device qui 
possède un certificat. 

1. Connectez votre device au Mac via un port USB. 

2. Ouvrez, dans Xcode, l’application que vous voulez installer sur votre device. 

3. Déroulez le menu Window et cliquez sur Organizer. Cette action affiche la fenêtre 
Organizer. Cliquez sur votre device dans la marge gauche et repérez la version 
d’iOS installée sur ce device. 

4. Refermez la fenêtre Organizer. 

5. De retour dans Xcode, cliquez sur la première icône dans le volet de navigation 
et choisissez la même version d’iOS dans la liste Deployment Target. 

6. Sélectionnez votre device dans la liste déroulante Scheme, comme sur la figure 
23.25. 

7. Cliquez sur Run. 
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900 



Figure 23.25 - Sélectionnez votre device dans la liste déroulante Scheme 

Une boîte de dialogue vous signale qu’une clé de votre trousseau va être utilisée pour 
signer l’application. Validez en cliquant sur Autoriser, comme à la figure 23.26. 



codesign veut signer à l’aide de la clé « Michel 
Martin » de votre trousseau. 

Voulez-vous permettre l'accès à cet élément ? 


► Détails 

(?) i ( Toujours autoriser ) 


^ Refuser ) 


Q Autoriser 


; 


Figure 23.26 - Une boîte de dialogue signale qu’une clé de trousseau va être utilisée 
pour signer l’application 

L’application est compilée, copiée sur le device puis exécutée. 

Installer la dernière version de iOS sur un matériel 

Connectez votre device à un port USB du Mac. L’application iTunes se lance auto- 
matiquement. Sélectionnez votre device dans le volet gauche de iTunes, sous le libellé 
APPAREILS. La version d’iOS est affichée dans la partie droite de la fenêtre. Si une 
mise à jour est disponible, elle est affichée dans le cadre Version. Il vous suffit alors 
de cliquer sur Mettre à jour. 


Faire des captures d’écran 

Il est très simple de faire une capture d’écran sur un iPhone, un iPod Touch ou un 
iPad : appuyez simultanément sur les boutons Menu et Verrouillage, comme le montre 
la figure 23.27. 

Vous devriez entendre le son qui est habituellement émis lorsque vous prenez une photo. 
C’est bon signe! Cela veut dire que la capture d’écran s’est bien faite. 
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Figure 23.27 - Il faut appuyer simultanément sur les boutons Menu et Verrouillage 
pour faire une capture d’écran 
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Pour accéder à la capture, lancez l’application iPhoto et cliquez sur votre device, sous 
APPAREILS. Sélectionnez les photos à importer sous Nouvelles photos (1) et cliquez 
sur Importer la sélection (2) (23.28). 



Figure 23.28 - La capture est présente dans l’application iPhoto 



Vous pouvez également cliquer sur le deuxième bouton Importer pour im- 
porter toutes les photos affichées sous Nouvelles photos. 


En résumé 

- Pour déboguer une application, rien de tel que le volet de débogage de Xcode. Pour 
l’afficher, il suffit de cliquer sur l’icône Hide or show the Debug area. 

- L’instruction NSLogO permet d’afficher des données alphanumériques dans le volet 
de débogage. Précisez le type de la donnée à afficher en utilisant un code "/„. Par 
exemple °/ 0 @ pour afficher un NSString, ou encore 7,f pour afficher un f loat ou un 
double. 

- Pour obtenir des informations depuis le volet de débogage, insérez un point d’arrêt 
dans le code. Une fois l’application stoppée sur le point d’arrêt, tapez la commande 
po objet dans le volet de débogage (où objet représente l’objet sur lequel vous 
voulez avoir des informations). 

- Pour pouvoir tester les applications que vous développez sur vos devices (mais aussi 
les diffuser dans l’App Store), vous devez souscrire au programme de développement 
iOS. 
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- Pour pouvoir tester vos applications sur un device, vous devez créer un profil d’ap- 
provisionnement . 

- Pour installer une application sur un device, il suffit de lancer la construction sur ce 
device (liste déroulante Scheme dans Xcode). 

- Pour mettre à jour iOS sur un device, connectez-le à votre Mac, sélectionnez-le dans 
iTunes, sous APPAREILS, puis cliquez sur Mettre à jour. 

- Pour faire une capture d’écran sur un device, appuyez simultanément sur les boutons 
Menu et Verrouillage. La capture est récupérée dans l’application iPhoto, après 
avoir cliqué sur votre device sous APPAREILS. 
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Proposer une application sur l’App 
Store 


Difficulté : _ 

C a y est, votre application est finalisée et vous êtes prêts à la diffuser sur l'App 
Store? De nombreuses étapes préliminaires sont nécessaires. Assez fastidieuses et 
/ partiellement expliquées dans l'aide d'Apple, je vais faire mon possible pour vous les 
expliquer aussi simplement que possible. 
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Préparation préliminaire 

L’organigramme ci-après représenté à la figure 24.1 résume les principales étapes né- 
cessaires pour proposer une application sur iTunes. N’hésitez pas à vous y référer tout 
au long de ce chapitre pour suivre votre avancement. 



Figure 24.1 - Les principales étapes nécessaires pour proposer une application sur 
iTunes 
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La distribution d'applications sur l'App Store se fait via le site Web iTunes 
Connect. Par son intermédiaire, vous indiquerez vos renseignements fiscaux 
et bancaires, vous définirez des contrats pour vos applications, vous afficherez 
vos rapports de ventes et bien d'autres choses encore. . . 


La première étape consiste bien entendu à écrire votre application et à la mettre au 
point dans le simulateur. 

Si vous lisez ces lignes, c’est que votre application a été testée et retestée et qu’elle est 
prête à être diffusée dans le vaste monde (ou alors que vous êtes juste curieux). Pas de 
précipitation ! Deux étapes préalables sont nécessaires. Vous devez : 

1. avoir souscrit au programme de développement standard (ou supérieur) ; 

2. vous connecter sur le site iTunes Connect, entrer les informations administra- 
tives nécessaires et obtenir un certificat de distribution pour l’application. 

Si vous n’avez pas encore souscrit à un programme de développement (ce qui m’éton- 
nerait fort), consultez la section intitulée « Souscrire au programme de développement 
iOS » du chapitre précédent (page 432). 


Paramétrage de iTunes Connect 


Ouvrez votre navigateur Web et connectez- vous sur iTunes Connect. 

(iTunes Connect 

> [Code web : 999498 j 

Entrez vos identifiants (Apple ID et mot de passe) puis cliquez sur Sign In. Cette 
étape franchie, le navigateur donne accès au portail iTunes Connect, représenté à la 
figure 24.2. 



Lors de votre première connexion à iTunes Connect, vous devrez approuver 
les conditions d'utilisation. Ce n'est qu'à cette condition que vous pourrez 
utiliser iTunes Connect. Lisez bien le contrat d'utilisation et validez. 


Contrats, taxes et informations bancaires 

Cliquez sur Contracts, Tax and Banking; vous arrivez sur la page représentée à la 
figure 24.3. Tous les contrats affichés doivent apparaître sous Contracts In Effect. 
Si certains apparaissent sous Contracts In Progress, cela signifie que les services 
correspondants ne sont pas utilisables, car les informations nécessaires n’ont pas été 
définies. 

Dans cet exemple, les informations relatives aux paiements (iOS Paid Applications) 
et au système de bannières publicitaires iAD n’ont pas été renseignées. Cliquez sur les 
boutons Set Up correspondants et définissez les informations demandées. 
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0 O 

JH ITunes Conncci 


iTunes Connect 


+ * O •- ■ 0 


apple.com AytiOhjfcv 


Û iTunes Connect 


m 


Art you looking for opportunités to générât* addioonal revenue and market your apps to millions of 
iPhone and iPod touch users around the world? Apple now offers two cholces to Help promote your apps 
and earn extra revenue through advertising. lAd Network allows you to create media-rich ads and earn 60 
percent of advertismg revenue generated by iAds served to your app. iAd for Developers gives you a 
unique, cost-effective way to promote your iOS 4 apps to millions of iPhone and iPod touch users. Learn 
more about the iAd Netwc • and iAd lor Developers and take advantage of these programs today. 


« 


il Sales and Trends 

jÆ Preview or download your daily and weekly sales 
information here. 

\ Contracte. Tax, and Banking 

Manage your contracte, tax. and banking 
: information. 


Y V Payments and Financial Reports 
1 View and download your monthly flnancial 
y* reports and payments. 

_ Manage Users 

Create and manage both iTunes Connect and In 
App Purchase Test User accounts. 


I V Manage Your Applications 

Al Add. view . and manage your applications in the 


Contact Us 

Having a problem uploadlng your application? 
Can't fmd a Finance Report? Use our contact Us 
System to fmd an answer to your question or to 
generate a question to an ITunes Rep 


m 


Download the Developer Guide. (?) FAQs Review our answers tocommon Inquirles. 


iTunes Connect Mobile 

Access your sales and trend Information anywhere. Get R free from the App Store. 


Home | FAQs | Contact Ui 





Figure 24.2 - Le portail iTunes Connect 



Figure 24.3 - Contracts , Tax and Banking 
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Une fois toutes les informations nécessaires fournies, le statut des contrats devient 
« Processing ». Vous serez informés par e-mail lorsque les contrats seront validés et 
actifs. La page Contracts, Tax and Banking se présentera alors comme à la figure 
24.4. 


900 
J □ IT unts ConiM 


ITunes Connect 


■ÿ O | ■ De confiance 

É iTunes Connect 


rcr apptexom *<DOb«a 


il- 


Contracts, Tax, and Banking 


Contracts In Effect 

Connaît Région Connaît Type Contrait Num 

Ail iSee Contran) IOS Paul MS60J4229 

AppHcationt 

World IAd Network MS5297420 

World tOS fret MSS74JM4 

Applications 


■ftk Info T ai Info Eff «cliva Date Eaplrallon Date Download 

Edtt View Nov 22.2011 On 02. 2012 — 


Edit View 


On 19. 2011 Oct 02, 2012 


Figure 24.4 - Le statut des contrats est « Processing » 


Obtenir le certificat de distribution 

Dans la section « Créer un profil d’approvisionnement » du chapitre précédent, vous 
avez appris à définir puis à mettre en place un profil d’approvisionnement pour tester 
vos applications sur un device. Eh bien, vous allez devoir faire une manipulation si- 
milaire pour obtenir un profil d’approvisionnement qui vous permettra de poster vos 
applications sur l’App Store. 


Création d’une demande de certificat 

Cliquez sur l’icône Applications dans le dock. Ouvrez le dossier Utilitaires et 
cliquez sur l’icône Trousseau d’accès. Lancez la commande Préférences dans le 
menu Trousseau d’accès. Basculez sur l’onglet Certificats et assurez-vous que les 
deux premiers paramètres ont pour valeur Désactivé (e) , comme à la figure 24.5, puis 
fermez la boîte de dialogue Préférences. 

Déroulez le menu Trousseau d’accès, pointez Assistant de certification et cli- 
quez sur Demander un certificat à une autorité de certificat. Cette commande 
provoque l’affichage de la boîte de dialogue Assistant de certification (figure 
24.6). Remplissez cette boîte de dialogue comme ceci : 
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Figure 24.5 - Les deux premiers paramètres ont pour valeur Désactivé (e) 

- entrez l’adresse e-mail utilisée lorsque vous vous êtes enregistrés en tant que déve- 
loppeur dans la zone de texte Adresse électronique de l’utilisateur; 

- entrez le nom utilisé lorsque vous vous êtes enregistrés en tant que développeur dans 
la zone de texte Nom commun ; 

- laissez la zone de texte Adresse électronique de l’ AC vide; 

- sélectionnez le bouton radio Enregistrée sur disque et cochez la case Me laisser 
indiquer les informations sur la bi-clé. 


0 O ^ Assistant de certification 

Informations sur le certificat 

Saisissez les informations relatives au certificat que vous 
demandez. Cliquez sur Continuer pour demander un 
certificat de l’AC. 

Adresse électronique de l'utilisateur : lem.korp@free.fr ▼ 

Nom commun : Michel Martin 
Adresse électronique de l'AC : 

La requête est : Envoyée à autorité de certif. par courriel 

© Enregistrée sur disque 

Me laisser indiquer les informations sur la bi-clé 


Continuer 


Figure 24.6 - La boîte de dialogue Assistant de certification 

Cliquez sur Continuer. L’Assistant donne un nom au certificat. Choisissez un empla- 
cement pour le sauvegarder, puis cliquez sur Enregistrer. 
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Dans la boîte de dialogue suivante (figure 24.7), sélectionnez 2048 bits dans la liste 
déroulante Dimension de clé, et RSA dans la liste déroulante Algorithme, cliquez sur 
Continuer, puis sur Terminer. Le certificat a été créé et sauvegardé à l’emplacement 
choisi. 



Figure 24.7 - Choisissez les paramètres de la bi-clé 


Soumission de la demande de certificat 

Connectez-vous sur le portail des développeurs Apple, entrez vos identifiants et cli- 
quez sur iOS Provisioning Portai, sur Certif icates dans le menu de gauche, puis 
sélectionnez l’onglet Distribution. 

fPortail des développeurs ^ 

[ Code web : 870612 y 

Cliquez sur Request certif icate puis sur Choisir. Désignez le fichier qui a été créé à 
l’étape précédente (Certif icateSigningRequest . certSigningRequest) puis cliquez 
sur Submit. Au bout de quelques secondes, le certificat est affiché dans le navigateur, 
comme à la figure 24.8. 

Cliquez sur Click here to download now pour le télécharger et enregistrez-le où bon 
vous semble. Un fichier nommé AppleWWDRCA . cer est ainsi créé. Double-cliquez sur ce 
fichier pour ouvrir l’application Trousseau d’accès et installer le certificat. 

Toujours dans la page iOS Provisioning Portai, cliquez sur le bouton Download 
affiché dans la partie droite de la fenêtre. Une boîte de dialogue de téléchargement 
est affichée. Sauvegardez le fichier distribution_identity . cer où bon vous semble. 
Une fois le fichier téléchargé, double-cliquez dessus pour ouvrir l’application Trousseau 
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Figure 24.8 - Le certificat est affiché dans le navigateur 

d’accès et installer le certificat de distribution. 


Création et téléchargement du profil de distribution iOS pour l’App Store 

Connectez-vous sur le site iOS Developer Portai. Cliquez sur Member Center et en- 
trez vos identifiants. Cliquez sur Provisioning dans la partie gauche de la fenêtre et 
sélectionnez l’onglet Distribution. 

iOS Developer Portai 
^ Code web : 621357 , 

Cliquez sur New Profile. En face de Distribution Method, sélectionnez le bouton 
radio App Store et complétez les informations demandées. 

Cliquez sur Submit. Le profil de distribution est affiché dans le navigateur avec un 
statut Pending, comme à la figure 24.9. 

Il ne vous reste plus qu’à patienter jusqu’à l’activation de ce profil. Une fois activé, 
cliquez sur Download pour le télécharger, puis glissez-déposez l’icône du fichier télé- 
chargé sur celle de Xcode dans le dock. Cette action provoque l’affichage de la fenêtre 
Organizer, dans laquelle apparaît votre profil de distribution (figure 24.10). 


Préparer une application pour la diffusion 

Pour qu’une application puisse être soumise à l’App Store, deux actions doivent être 
effectuées dans Xcode : 

1. préparation du fichier plist ; 
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Figure 24.9 - Le profil de distribution est affiché dans le navigateur avec un statut 
Pending 
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Figure 24.10 - La fenêtre Organizer s’affiche 
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2. archivage. 


Préparation du fichier plist 

Développez le dossier Support ing files dans le volet de navigation et cliquez sur 
nom-inf o .plist (où nom représente le nom de votre application). 

Assurez-vous que la clé Bundle version contient la version de votre application (1.0 
si vous publiez cette application pour la première fois). Vérifiez qu’une icône a bien été 
définie pour votre application. Dans ce cas, les clés Icon files et Icon files (iOS 
5) doivent être différentes de 0. 

Cliquez du bouton droit dans la partie droite de la fenêtre et sélectionnez Add Row 
dans le menu contextuel. Définissez la clé CFBundlelconFile. Lorsque vous appuyez 
sur la touche [ Entrée ) de votre clavier, CFBundlelconFile se transforme en Icon 
file. Double-cliquez dans la partie Value de cette nouvelle clé et entrez le nom de 
l’icône de l’application. 


Nettoyage et archivage 

Lancez la commande Clean dans le menu Product pour « nettoyer » l’application, 
c’est-à-dire la débarrasser des éventuelles références vers des éléments qui auraient été 
supprimés. 

Sélectionnez iOS Device dans la liste déroulante Scheme, dans l’angle supérieur gauche 
de la fenêtre de Xcode, comme indiqué à la figure 24.11. 




e o o 

| Win7AstucesTl iOS Device 


Run Stop 

DetailViewController.m 


Breakpoints 



Win7AstucesTl 


Figure 24.11 - Sélectionnez iOS Device dans la liste déroulante Scheme 


Lancez la commande Edit Scheme dans le menu Product. Cette commande affiche la 
boîte de dialogue Scheme. Basculez sur l’onglet Archive dans le volet gauche et vérifiez 
que la valeur Release est sélectionnée dans la liste déroulante Build Configuration. 
Si nécessaire, modifiez le nom de l’application dans la zone de texte Archive Name. 
Assurez-vous que la case Reveal Archive in Organizer est cochée (figure 24.12), 
puis cliquez sur 0K. 

Lancez la commande Archive dans le menu Product. Lorsque la compilation est ter- 
minée, l’application est affichée dans la fenêtre Organizer, sous l’onglet Archives, 
comme le montre la figure 24.13. 
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_îj [ IOS Device ; ] [ m ] 

Destination Breakpoints 
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^ Debug 

t Profile pong.app 

* Release 

Analyze 

Debug 


Archive 

* Release 


Build Configuration Release 
Archive Name 

Options 0 Reveal Archive in Organizer 


Duplicate Scheme | | Manage Schemes... 


Figure 24.12 - Cochez la case Reveal Archive in Organizer 
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Figure 24.13 - L’application est affichée dans la fenêtre Organizer 
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Configuration de iTunes Connect 
Documents et images nécessaires 

Lors du référencement de l’application sur iTunes Connect, vous aurez besoin de plu- 
sieurs éléments textuels et graphiques. Mieux vaut les rassembler avant de vous rendre 
sur iTunes Connect. 

- Ecrivez un texte pour décrire votre application (Apple recommande que ce texte ne 
dépasse pas 700 caractères). 

- Choisissez un nombre unique pour votre application. Vous pouvez par exemple choi- 
sir la date de soumission de l’application. Par exemple « 23112011 ». À moins que 
vous ne soumettiez plusieurs applications dans la même journée. . . ce numéro sera 
effectivement unique. 

- Effectuez entre une et quatre captures d’écran. Ces images doivent avoir une taille 
de 640 x 960 pixels si l’application est destinée aux iPhone ou iPod Touch. Elles 
doivent avoir une taille de 1024 x 768 pixels si l’application est destinée aux iPad. 

- Définissez une image JPEG de 512 x 512 pixels. Cette image doit être aussi proche 
que possible de l’icône de l’application. 

Une fois tous ces éléments en votre possession, vous êtes prêts pour la prochaine étape : 
le référencement de l’application dans iTunes Connect. 


Référencer l’application dans iTunes Connect 

Ouvrez votre navigateur Web et connectez-vous sur iTunes Connect. Entrez vos iden- 
tifiants (Apple ID et mot de passe) puis cliquez sur Sign In. 

fiTunes Connect 

[ Code web : 999498 , 

Cliquez sur Manage your applications, puis sur Add New App. 

Entrez la langue de développement (la langue utilisée pour donner les détails de l’ap- 
plication) et le nom de société ou de développeur que vous souhaitez voir apparaître 
dans l’App Store pour toutes vos applications. 

Ces deux informations ne peuvent pas être facilement changées. Soyez sûrs 
que vous faites le bon choix. Si vous avez fait une erreur, il vous reste néan- 
moins une solution : vous pouvez passer par le service après-vente d'Apple. . . 
aux États-Unis ! 

Cliquez sur Continue. Vous devez maintenant indiquer le nom de l’application (App 
Name), un nombre unique associé à l’application (SKU Number), l’identifiant Bundle ID 
(Bundle ID), et un éventuel suffixe pour le Bundle ID, tel qu’il a été défini dans le 
fichier Info.plist (voir « Préparation du fichier plist » plus haut). 

Le champ SKU Number n’est pas utilisé dans l’App Store. Il s’agit d’une référence pour 
vous aider à identifier vos applications. Il peut être constitué d’une chaîne alphanumé- 
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rique quelconque. La date de publication par exemple. 

Si vous n’avez pas encore défini un Bundle ID (c’est-à-dire un identifiant pour votre 
application), reportez-vous à la section suivante. Dans le cas contraire, sélectionnez le 
Bundle ID de l’application dans la liste déroulante (figure 24.14). Assurez-vous qu’il 
correspond bien à l’identifiant de votre application, car il ne sera pas possible de le 
modifier par la suite. 



Figure 24.14 - Sélectionnez le Bundle ID de l’application dans la liste déroulante 


Définition d’un Bundle ID 

Si vous n’avez pas encore défini un Bundle ID pour votre application, cliquez sur You 

can register a new Bundle ID here sur la fenêtre de l’étape précédente. 

Définissez : 

- un nom pour identifier l’App ID (Description) ; 

- un identifiant (Bundle Identifier). Généralement, cet identifiant est constitué de 
votre nom de domaine inversé suivi d’un point décimal et du nom de l’application. À 
la figure 24.15, j’utilise mon propre nom de domaine, c’est-à-dire le nom de domaine 
du site sur lequel je vais parler de mes applications (mediaforma.com) que j’inverse 
(com.mediaf orma), et je le fais suivre du nom de l’application (com.mediaf orma. w7atl). 

Cliquez sur Submit. 

Le Bundle ID est immédiatement créé, mais, comme le montre la figure 24.16, vous 

devez le configurer pour le développement et pour la production. 

Cliquez sur Configure. Cochez la case Enable for Apple Push Notification service 

et cliquez sur le bouton Configure, en face de Production Push SSL Certificate. 
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Figure 24.15 - Définition d’un Bundle ID 



Figure 24.16 


Vous devez configurer le Bundle ID 
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Désignez le fichier Certif icateSigningRequest . certSigningRequest qui a été créé 
dans une étape précédente et validez. 

Le certificat de production a été validé, il ne vous reste plus qu’à le télécharger en 
cliquant sur le bouton Download. 

Cliquez sur Continue. Au bout de quelques secondes, un nouvel écran est affiché. In- 
diquez le jour de disponibilité de l’application (le jour actuel généralement). Choisissez 
le niveau de prix dans la liste déroulante Price Tier. Si nécessaire, cliquez sur View 
Pricing Matrix pour voir la grille de prix, visible à la figure 24.17. 
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Figure 24.17 - La grille des prix 



Cette capture d'écran a volontairement été coupée car bien trop large. J'ai 
réalisé cette coupure pour faire apparaître la colonne Tier et la colonne 
Europe - Euro, qui contient les informations qui nous intéressent. 


Décochez la case Discount for Educational Institutions si vous ne voulez pas 

qu’un rabais de 20 % soit accordé aux établissements scolaires. 

Cliquez sur Continue et entrez les informations demandées, comme indiqué à la figure 

24.18. 

- Le champ Version Number indique le numéro de version de l’application. Ce numéro 
doit suivre les standards de numérotation : 1.0, 1 . 1, 2 . 0, etc. N’utilisez pas un libellé 
« alpha » ou « beta » pour dire que l’application est en phase de test. 

- Le champ Description contient le texte qui sera affiché dans l’App Store. 

- Sélectionnez la catégorie principale de l’application et éventuellement une sous- 
catégorie (si vous avez choisi la catégorie Games). 

- Choisissez des mots-clés séparés par des virgules (jusqu’à 100 caractères). Choisissez- 
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les prudemment : ils feront ressortir l’application lors de recherches des utilisateurs 
dans l’App Store. De plus, ils ne pourront pas être changés jusqu’à ce qu’une nouvelle 
version de l’application soit disponible. 

- Le champ Contact Email Address sera utilisé par Apple si les validateurs ont des 
questions sur votre application. 

- Dans le champ Support URL, entrez l’URL à afficher dans l’App Store pour le support 
de l’application. Assurez-vous que cette URL correspond à une page Web existante. 

- Vous pouvez également saisir une URL dédiée à l’application (App URL), et/ou 
une URL dédiée si vous utilisez In App Purchase dans votre application (Privacy 
Policy URL). 

- Le champ Review Notes est destiné aux personnes qui vont valider votre application. 
Entrez tout commentaire que vous jugerez utile, ou laissez cette zone vide. 

- Assurez-vous que toutes les cases sous App Rating Detail sont sur None et que cela 
correspond bien à votre application. 

- Si vous voulez définir un contrat de licence d’utilisateur final, entrez le texte cor- 
respondant dans la zone EULA text (EULA est l’abréviation de End User License 
Agreement , soit en français « Contrat de licence d’utilisateur final ») et sélectionnez 
les pays concernés par la licence. 

- Sous Uploads, vous devez fournir une icône de 512 x 512 pixels au format PNG, 
ainsi qu’une ou plusieurs captures d’écran sur iPhone et/ou iPad, selon la cible de 
l’application. 



Vous pouvez fournir jusqu'à cinq captures d'écran dans les sections iPhone 
and iPod Touch Screenshots et iPad Screenshots. Si nécessaire, les 
captures d'écran peuvent être déplacées avec la technique du glisser-déposer 
pour être mises dans l'ordre d'apparition souhaité sur I App Store. 


Cliquez sur Save. Votre application est maintenant prête à être proposée aux valida- 
teurs chez Apple. Le statut de l’application est « Préparé for upload ». Cliquez sur View 
Details puis sur Ready to Upload Binary. Après quelques instants, l’application a 
le statut « Waiting for Upload » (figure 24.19). 
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Figure 24.18 - Entrez les informations demandées 



Figure 24.19 - L’application a le statut « Waiting for Upload » 
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Validation et soumission d’une application 

Vous voilà dans la dernière ligne droite. À la fin de cette section, vous saurez comment 
valider et soumettre une application sur l’App Store. 

Ouvrez Xcode et cliquez sur l’icône Organizer dans l’angle supérieur droit de la fenêtre. 
Cette action affiche la fenêtre Organizer. Basculez sur l’onglet Archives. L’application 
à valider et à soumettre doit apparaître dans cette fenêtre, comme à la figure 24.20. 


« O O 

Organizer - Archives ** 

IB a y 

Devices Repos.tones Projects Archives Documentation 

Wm7AstucesT 1 

Win7AstucesTl 

Windows 7 wln7A *' uc “ Tl fv5*;« 

Création Date: 24 novembre 2011 15 08 

Astuces i.o I 

T OfTVC 1 Identifier com.mediaforma.w7atl 




Nam* Création Date « Comment Status 

u.niümwn " 1 1 mi in 



Figure 24.20 - L’application à valider et à soumettre doit apparaître dans la fenêtre 

Organizer 

Cliquez sur Validate. Après quelques instants, si tout se passe bien, le statut de 
l’application deviendra Passed Validation. Si des problèmes sont détectés pendant 
la validation, une boîte de dialogue semblable à la figure 24.21 sera affichée. 

Corrigez les erreurs et recommencez la validation. Une fois que tout est correct, une 
fenêtre devrait s’afficher vous disant que tout est bon. 

Lorsque le statut de l’application est Passed Validation, cliquez sur Submit. L’ap- 
plication aura alors le statut Submitted dans la fenêtre Organizer et Waiting for 
Review dans iTunes Connect. 

Il ne vous restera plus qu’à attendre que votre application soit validée par l’équipe de 
l’App Store. En général, le délai nécessaire est d’environ une semaine. . . 
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The following issues were found during validation: 


The Bundle ID Mediaforma.Win7AstucesTl defined in your Xcode Project does 
not match the Bundle ID that you entered for this app in iTunes Connect 
com.mediaforma.w7atl. 


iPad Info.plist: Unable to verify icon dimensions, no icon found. You must 
O define CFBundlelcons, CFBundlelconFiles. CFBundlelconFile. or provide a 
default lcon-72.png that is 72x72 

^ Application failed codesign vérification. The signature was invalid, or it was 
not signed with an iPhone Distribution Certificate. 


L 

j Cancel 


Previous ( Finish 


Figure 24.21 - Des problèmes ont été détectés lors de la validation 


Quand votre application est acceptée. . . 


Lorsque votre application est acceptée sur l’App Store, vous recevez un e-mail indiquant 
« Your application is ready for sale », c’est-à-dire « Votre application est prête à être 
commercialisée ». Je vous conseille de retourner dans iTunes Connect. Entrez vos 
identifiants et connectez-vous. Cliquez sur Manage Your Applications, puis cliquez 
sur l’icône de l’application pour accéder à ses informations. 

Cliquez sur Rights and Pricing et changez la date de disponibilité de votre applica- 
tion en la remplaçant par sa date d’approbation dans l’App Store. Ainsi, vous appa- 
raîtrez en tête des applications publiées sur l’App Store. 

Cette technique est très intéressante, mais elle ne peut être appliquée qu'une 
fois, pour faire correspondre la date de publication avec la date d'approbation. 

Si vous le souhaitez, vous pouvez modifier plusieurs informations concernant votre 
application (descriptions, copies d’écran, prix) et ce, sans devoir passer par le processus 
d’approbation. 

Il n'est pas possible de changer les mots-clés associés à l'application, à moins 
de publier une mise à jour de l'application. 
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Si vous avez créé une page pour faire la promotion de votre application, vous pouvez 
y insérer un lien permettant à vos visiteurs de l’acheter. Ce lien devra être le suivant : 


ht tp : // i tune s . apple . com/WebObjects/MZStore . woa/wa/viewSoftware? 
id=identif iant &mt =8 


Dans cette URL, remplacez identifiant par l’identifiant de votre application (celui-ci 
vous a été communiqué dans l’e-mail « Ready for Sale »). 

Il ne reste plus qu’à faire autant de publicité que vous le pourrez pour promouvoir 
votre application. Vous devriez en particulier songer à parler de votre application sur 
les réseaux sociaux, sur les sites Web dédiés aux applications iOS, et dans les revues 
spécialisées (papier et en ligne). 


Gagner de l’argent avec une application 


Pour gagner de l’argent avec une application, vous pouvez : 

1. la diffuser gratuitement sur l’App Store et y inclure une bannière publicitaire 
(iAd) ; 

2. la vendre sur l’App Store. 


En marge de ces deux modèles, vous pouvez également proposer une application gra- 
tuite, sans publicité. . . mais incomplète. 


Placez-y un certain nombre de fonctionnalités qui donneront envie à ses utilisateurs 
d’acheter la version complète qui, elle, sera payante. En utilisant la technique « In-App 
Purchase », l’achat pourra se faire depuis l’application gratuite. Si vous voulez en savoir 
plus sur cette possibilité, consultez le site développer . apple . com. 


> 


développer . apple . com 
^ Code web : 919065 


Insérer de la publicité dans une application 

Pourquoi ennuyer vos utilisateurs avec des annonces publicitaires ? Eh bien tout sim- 
plement parce que de cette façon, vous pouvez leur proposer des applications gratuites 
tout en générant un revenu. Le principe est simple : chaque fois qu’une annonce pu- 
blicitaire est affichée, vous êtes rémunérés. À vous de trouver un juste milieu pour que 
vos utilisateurs ne soient pas trop dérangés et continuent à utiliser votre application 
malgré l’affichage des annonces publicitaires. 

La taille de la bannière publicitaire dépend du mode d’affichage de l’application et du 
device utilisé : 

- En affichage « Portrait » : 320 x 50 pixels sur iPhone et iPod Touch, 768 x 66 pixels 
sur iPad. 
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- En affichage « Paysage » : 480 x 32 pixels sur iPhone et iPod Touch, 1024 x 66 pixels 
sur iPad. 

Pour afficher une bannière publicitaire dans une application, il suffit d’utiliser le fra- 
mework iAd. Voyons comment mettre cela en pratique. 


Le framework iAd 

Définissez une nouvelle application de type Single View Application et donnez-lui 
le nom « iAd ». Dans un premier temps, vous allez insérer le framework iAd dans 
l’application. Comme indiqué à la figure 24.22, cliquez sur la première icône dans le 
volet de navigation (1) et sélectionnez l’onglet Build Phases (2) dans la partie centrale 
de la fenêtre. Développez la zone Link Binary With Libraries (3), cliquez sur l’icône 
+ (4) et ajoutez le framework iAd. framework (5). 
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Figure 24.22 - Ajoutez le framework iAd 


Le framework étant inclus dans l’application, vous allez y faire référence dans le fi- 
chier d’en-têtes. Cliquez sur ViewController .h dans le volet de navigation et ajoutez 
l’instruction #import suivante : 

il # import <iAd/iAd.h> 


Pour traiter les événements relatifs aux iAds, insérez le delegate ADBannerViewDelegate 
dans la définition de l’interface : 


î 


©interface ViewController : UlViewController < 
ADBannerViewDelegate > 
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Enfin, définissez la variable d’instance bannerView de classe ADBannerView : 
l| ADBannerView ♦bannerView; 

Le fichier d’en-tétes doit maintenant ressembler à ceci : 

1 # import <UIKit/UIKit.h> 

2 #import <iAd/iAd.h> 

3 ^interface ViewController : UlViewController < 

ADBannerViewDe légat e > 

4 <Send 

Vous allez maintenant ajouter une bannière publicitaire dans la vue 1 . Cliquez sur 
MainSToryboard. storyboard dans le volet de navigation et ajoutez dans l’application 
un contrôle AdBannerView, comme à la figure 24.23. 



« O O 

2] iAd.xcodeproj — g MainSloryboard.storyboarc 

.* 

► 

^ Finished running iAd on iPhone 5.0 Simulator 

BUE b HaB ibi 

Rufl 

Scheme Breakpointi — — - 


MainStoryboard.storyboard 


ta Tl O 

£ S • ^ | S! * ► , -j - b MamStofyboard.stocv No Selectron D S S *•* O 




T -3 1 ui gu. iOS 

» 



► fê lAd.framewor k 

▼ fcJ iAd 


h AppOelegate h 
m AppOelegate m 


[h ViewContro4l«r.h 

m ViewControIkrm 
► Supporting Fikî 

► Lj Framework} 

► k_j Products 


Figure 24.23 - Ajoutez un contrôle AdBannerView dans l’application 


Cliquez sur l’icône Show the Assistant editor dans la barre d’outils et créez l’outlet 
banner pour le contrôle AdBannerView. 

Le fichier d’en-têtes doit maintenant contenir le code suivant : 


î 

2 

3 


# import CUIKit/UIKit .h> 
#import <iAd/iAd.h> 


1. Apple recommande de placer la bannière dans la partie supérieure ou inférieure de la vue. 
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4 ©interface ViewCont r oller : UlViewController < 

ADBannerViewDelegate > 

5 ©property (weak , nonatomic) IBOutlet ADBannerView *banner; 

6 ©end 

Il ne reste plus qu’à écrire quelques lignes de code pour implémenter la bannière publi- 
citaire. Mais avant de vous mettre au travail, je vous suggère de consulter l’aide Apple 
sur la classe ADBannerView et sur le protocole ADBannerViewDelegate. Vous aurez 
ainsi une idée des méthodes à utiliser. 

Cliquez sur l’icône Organizer dans la barre d’outils de Xcode et faites une recherche 
sur la classe ADBannerView. En parcourant le contenu de cette aide (figure 24.24), 
vous voyez que vous devez préciser les dimensions de la bannière avec la propriété 

requiredContentSizeldentif iers. 


W O O Organizer - Documentation 

i q b y 

Devices Repositones Project* Archn/es Documentation 
i Cp 1 5U ^ ► it IOS S.O Library I J User Expérience ADBannerView Class Reference 

Or ADBannerView O, I 

requiredContentSizeldentifiers 

A set of identifiers for the sizes of advertisements that the banner view can display. 
$property( nonatomic, copy) NSSet «requiredContentSizeldentifiers 
Discussion 

Banner views must always bave dimensions that match the size of a known 
advertising format. Your application sets the requiredContentSizeldentifiers 
property so that the banner view can download advertisements that provide artwork 
for those sizes. The known sizes are listed In 'Content Size Identifiers.' The default 

value is a set induding both AOBannerContentSizeldentif îerPortrait and 
ADBannerContentSizeldentif ierLandscape. 

If the set includes a single identifier, then advertisements downloaded by the banner 
view hâve a banner image with that size. If the set includes multiple identifiers, 
advertisements downloaded by the banner view mdude images for ail sizes specified 
in the set. This allows the banner view to be resized without having to download 
additional images. Do not mdude identifiers for sizes that your application does not 
use. as it may unnecessarily restrict the inventory of advertisements available to your 
application. 

Setting the requiredContentSizeldentifiers property does not resize the banner 
view. To change the size of the banner view, your application sets the 

currentContentSizeldentif ier property. 

Availability 

Available in iOS 4.0 and later. 

See Also 

f property currentContentSizeldentif ier 

Declared In 

ADBannerView. h 


ADBannerViewDeleqate 
f System Guides 

Banner View Concepts 
Techmcal Q&A QA1641 
Tools Guides 


Sample Code 

iAdSuite 


Figure 24.24 - L’aide d’Apple concernant la classe ADBannerView 

Maintenant, parcourez l’aide sur le protocole ADBannerViewDelegate. Vous voyez que 
plusieurs méthodes événementielles seront générées par la bannière. En particulier : 

- bannerViewDidLoad, lorsque la bannière publicitaire a été chargée; 

- bannerViewActionShouldBegin:willLeaveApplication :, lorsque l’utilisateur clique 
sur la bannière publicitaire ; 

- bannerViewActionDidFinish, lorsque l’utilisateur ferme l’encart publicitaire; 

- bannerView: didFailToReceiveAdWithError : appelée si la bannière publicitaire n’a 
pas pu être chargée. 
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Lorsque l'utilisateur clique sur un encart publicitaire, la méthode 
bannerViewActionShouldBegin:willLeaveApplication: est exécutée. 
Selon les paramètres fournis à cette méthode (tout ceci est précisé dans 
l'aide), l'application peut alors passer en arrière-plan et la publicité s'afficher. 
Ce n'est qu'une fois que la publicité aura été vue et fermée par I ’ utilisateur 
que l’application reprendra le contrôle. 


Mais assez palabré. Il est temps d’écrire le code de l’application ! 

Cliquez sur ViewController .m dans le volet de navigation et complétez la méthode 
viewDidLoad comme suit : 

1 - (void) viewDidLoad 

2 { 

3 [super viewDidLoad]; 

4 banner . r equir edC ont ent S ize Ident if ier s = [NSSet s etWi thûb j ec t s 

: ADBannerCont ent S ize Ident if ierPort r ait , 

ADBannerCont ent S ize Ident if ierLands cape , nil] ; 

5 banner . delegate = self; 

6 } 


La ligne 4 indique que l’application sera utilisée en mode portrait et en mode paysage. 

La ligne 5 indique que la gestion des événements relatifs à la bannière publicitaire sera 
traitée dans la classe courante. 

Ajoutez les méthodes suivantes : 


î 

2 

3 

4 

5 

6 

7 

8 
9 

10 

11 

12 


- (B00L ) bannerView Act ionShouldBegin : ( ADBannerView *) banner 

willLeaveApplication : (B00L) willLeave 

{ 

return YES ; 

} 


- ( void) bannerViewAct i onDidFini sh :( ADBannerView *) banner 

{ 

} 


- (void) bannerView :( ADBannerView *) banner 

didFai IToRe cei ve AdWit hEr r or : (SSError *) error 

{ 

} 


L’unique instruction de bannerViewActionShoiildBegin: willLeaveApplication : de- 
mande que l’action relative à la bannière soit exécutée. Une valeur NO aurait bloqué 
cette action. Les deux autres méthodes ne contiennent aucune instruction, mais rien 
ne vous empêche de les compléter pour effectuer des traitements spécifiques à vos ap- 
plications. 

Il ne reste plus qu’à modifier la taille de la bannière en fonction de l’orientation du 
device. Complétez le code comme ceci : 
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1 - ( BOOL ) shouldAut or ot at eTo Int er f ace Or ient at ion : ( 

UI Interface Orientât ion) interface Orientât ion 

2 { 

3 if ( UI Int erf aceOr ient at ionl sLands cape ( inter f aceOr ient at ion ) ) 

4 banner . cur rente ont ent Size Ident if ier = 

ADBannerContentSizeldentif ierLandscape ; 

5 else 

6 banner . cur rente ont ent Size Ident if ier = 

ADBannerContentSizeldentif ierPortrait ; 

7 return YES ; 

8 } 


Si le device affiche en mode paysage, la taille de la bannière est initialisée en consé- 
quence. Si le device affiche en mode portrait, la taille de la bannière est ajustée avec la 
constante dédiée à ce mode d’affichage. Il ne vous reste plus qu’à lancer l’application. 
Le résultat se trouve en figure 24.25. 



Figure 24.25 - L’application avec la pub 

Cette application se trouve dans le dossier iAd. 

^Copier ce code ^ 

1 Code web : 811925 , 


ViewController .h 


1 

2 


# import CUIKit/UIKit .h> 
# import <iAd/iAd.h> 
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^interface ViewController : UlViewController < 
ADBannerViewDe légat e > 

Oproperty (weak , nonatomic) IBOutlet ADBannerView *banner; 
Oend 


.ewController . m 


#import "ViewController .h" 

@ implementat ion ViewController 
Ssynthesize banner ; 

- ( void) didRecei veMemoryWarning 

{ 

[super didReceiveMemoryWarning] ; 

// Release any cached data, images , etc that aren't in use. 

} 

#pragma mark - View lifecycle 

- ( void) viewDidLoad 

{ 

[super viewDidLoad]; 

banner . r equir edC ont ent S ize Ident if ier s = [NSSet s etWi thOb j ec t s 
: ADBannerCont ent S ize Ident if ierPort r ait , 

ADBannerCont ent S ize Ident if ierLands cape , nil] ; 
banner . delegate = self; 

} 

- ( void) bannerViewDidLoadAd :( ADBannerView *) banner 

{ 

// t ableView . t ableHeaderView = bannerView; 

} 

- (B00L ) bannerView Act ionShouldBegin :( ADBannerView *) banner 

willLeaveApplication : (B00L) willLeave 

{ 

return YES ; 

} 

- ( void) bannerViewAct ionDidFinish :( ADBannerView *) banner 

{ 

} 


- ( void) bannerView :( ADBannerView *) banner 

didFai IToRe ce i ve AdWit hEr r or : (SSError *) error 


{ 

} 
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- ( vo id ) viewDidUnload 

{ 

banner = nil ; 

[self setBanner : nil] ; 

[super viewDidUnload]; 

// Release any retained subviews of the main view . 

// e.g. self . myOutlet = nil; 

} 

- (void)viewWillAppear:(B00L) an i mat ed 

{ 

[super viewWillAppear : animated] ; 

} 

- (void) viewDidAppear : (B00L) animated 

{ 

[super viewDidAppear : animated] ; 

} 

- (void)viewWillDisappear:(BOOL) animated 

{ 

[super viewWillDisappear : animated] ; 

} 

- (void) viewDidDisappear : (B00L) animated 

{ 

[super viewDidDisappear : animated] ; 

} 

- (B00L) shouldAutorotateToInterfaceûrientation : ( 

UI Interface Orientât ion) interface Orientât ion 

{ 

if (Ullnterf aceOrientationlsLandscape (interface Orientât ion) ) 
banner . cur rent C ont ent S i ze Ident if ier = 

ADBannerC ont ent S izeldent if ierLands cape ; 

else 

banner . cur rent C ont ent Size Ident if ier = 

ADBannerC ont ent S izeldent if ierPortrait ; 
return YES ; 

} 


®end 


!n résumé 

Pour proposer à Apple une application que vous avez développée, vous devez successi- 
vement écrire, tester et retester l’application, souscrire au programme Développeurs, 
saisir des informations administratives sur l’application dans iTunes Connect, ob- 
tenir un contrat de distribution pour l’application, préparer l’application pour la 
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diffusion, ajouter l’application dans iTunes Connect, valider puis soumettre l’appli- 
cation. 

- Pour gagner de l’argent avec une application, vous pouvez la diffuser gratuitement 
sur l’App Store et y inclure une bannière publicitaire ou la vendre sur l’App Store. 

- Pour afficher une bannière publicitaire dans une application, vous utiliserez le fra- 
mework iAd. Insérez un contrôle AdBannerView dans l’application et traitez les évé- 
nements relatifs aux iAds via le delegate ADBannerViewDelegate. 
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